QuickGrid<TGridItem> 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
그리드를 표시하는 구성 요소입니다.
[Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")]
public class QuickGrid<TGridItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
[<Microsoft.AspNetCore.Components.CascadingTypeParameter("TGridItem")>]
type QuickGrid<'GridItem> = class
inherit ComponentBase
interface IAsyncDisposable
Public Class QuickGrid(Of TGridItem)
Inherits ComponentBase
Implements IAsyncDisposable
형식 매개 변수
- TGridItem
표의 각 행이 나타내는 데이터 형식입니다.
- 상속
- 특성
- 구현
생성자
| Name | Description |
|---|---|
| QuickGrid<TGridItem>() |
의 인스턴스를 생성합니다 QuickGrid<TGridItem>. |
속성
| Name | Description |
|---|---|
| AdditionalAttributes |
만든 요소에 적용할 추가 특성의 컬렉션을 가져오거나 설정합니다. |
| Assets |
애플리케이션에 ResourceAssetCollection 대한 값을 가져옵니다. (다음에서 상속됨 ComponentBase) |
| AssignedRenderMode |
이 구성 요소에 IComponentRenderMode 할당된 값을 가져옵니다. (다음에서 상속됨 ComponentBase) |
| ChildContent |
이 인스턴스의 자식 구성 요소를 정의합니다. 예를 들어 기본 클래스에서 파생된 구성 요소를 추가하여 열을 정의할 ColumnBase<TGridItem> 수 있습니다. |
| Class |
선택적 CSS 클래스 이름입니다. 지정된 경우 렌더링된 테이블의 클래스 특성에 포함됩니다. |
| ItemKey |
필요에 따라 렌더링된 각 행에 대한 @key 값을 정의합니다. 일반적으로 각 데이터 항목에 대해 기본 키 값과 같은 고유 식별자를 지정하는 데 사용해야 합니다. 이렇게 하면 TGridItem 인스턴스가 새 복사본으로 대체되는 경우에도(예: 기본 데이터 저장소에 대한 새 쿼리 후) 행 요소와 데이터 항목 간의 연결을 고유 식별자에 따라 유지할 수 있습니다. 설정 @key 하지 않으면 TGridItem 인스턴스 자체가 됩니다. |
| Items |
그리드에 대한 쿼리 가능한 데이터 원본입니다. 확장 메서드 또는 EntityFramework DataSet IQueryable 또는 파생된 데이터를 사용하여 AsQueryable(IEnumerable) 쿼리 가능으로 변환된 메모리 내 데이터일 수 있습니다. 둘 다 Items 제공하거나 ItemsProvider제공하지 않아야 합니다. |
| ItemSize |
이 기능은 .를 사용하는 Virtualize경우에만 적용됩니다. 각 행에 대해 예상 높이를 픽셀 단위로 정의하여 가상화 메커니즘이 표시 크기와 일치하고 정확한 스크롤을 보장하기 위해 올바른 수의 항목을 가져올 수 있도록 합니다. |
| ItemsProvider |
그리드에 대한 데이터를 제공하는 콜백입니다. 둘 다 Items 제공하거나 ItemsProvider제공하지 않아야 합니다. |
| OnRowClick |
Optional. 행을 클릭할 때 호출되는 콜백입니다. |
| OverscanCount |
이 기능은 .를 사용하는 Virtualize경우에만 적용됩니다. 스크롤하는 동안 렌더링 빈도를 줄이기 위해 표시되는 영역 전후에 렌더링할 추가 항목 수를 정의합니다. 값이 높을수록 화면에서 더 많은 항목을 렌더링하여 스크롤 부드러움을 향상시킬 수 있지만 초기 로드 시간을 늘릴 수도 있습니다. 데이터 세트 크기 및 사용자 환경 요구 사항에 따라 균형을 찾는 것이 좋습니다. 기본값은 3입니다. |
| Pagination |
필요에 따라 이 QuickGrid<TGridItem> 인스턴스를 PaginationState 모델과 연결하여 그리드가 현재 데이터 페이지만 가져오고 렌더링합니다. 일반적으로 Paginator 구성 요소 또는 제공된 PaginationState 인스턴스를 표시하고 업데이트하는 기타 UI 논리와 함께 사용됩니다. |
| RendererInfo |
RendererInfo 실행 중인 구성 요소를 가져옵니다. (다음에서 상속됨 ComponentBase) |
| RowClass |
Optional. CSS 클래스를 지정하기 위해 렌더링된 각 행에 대해 호출할 콜백입니다. |
| Theme |
기본값이 "default"인 테마 이름입니다. 이는 테이블과 일치하는 스타일 지정 규칙에 영향을 줍니다. |
| Virtualize |
true이면 그리드가 가상화로 렌더링됩니다. 일반적으로 스크롤과 함께 사용되며 그리드가 현재 스크롤 뷰포트 주위의 데이터만 가져오고 렌더링합니다. 이렇게 하면 큰 데이터 집합을 스크롤할 때 성능이 크게 향상될 수 있습니다. 사용하는 Virtualize경우 값을 ItemSize 제공해야 하며 모든 행이 동일한 상수 높이로 렌더링되도록 해야 합니다. 일반적으로 렌더링되는 데이터의 양이 작거나 페이지 매김을 사용하는 경우 사용하지 Virtualize 않는 것이 좋습니다. |
메서드
| Name | Description |
|---|---|
| BuildRenderTree(RenderTreeBuilder) |
그리드를 표시하는 구성 요소입니다. |
| DispatchExceptionAsync(Exception) |
제공된 이는 구성 요소 수명 주기 메서드 외부에서 예외가 발생하지만 구성 요소 수명 주기 메서드의 예외와 동일하게 처리하려는 경우에 유용합니다. (다음에서 상속됨 ComponentBase) |
| DisposeAsync() |
그리드를 표시하는 구성 요소입니다. |
| HideColumnOptionsAsync() |
ColumnOptions 이전에 표시된 UI를 닫습니다. |
| InvokeAsync(Action) |
연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다. (다음에서 상속됨 ComponentBase) |
| InvokeAsync(Func<Task>) |
연결된 렌더러의 동기화 컨텍스트에서 제공된 작업 항목을 실행합니다. (다음에서 상속됨 ComponentBase) |
| OnAfterRender(Boolean) |
구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 실행될 때까지 채워집니다. 이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다. (다음에서 상속됨 ComponentBase) |
| OnAfterRenderAsync(Boolean) |
구성 요소가 대화형으로 렌더링되고 UI가 업데이트를 완료할 때마다 호출되는 메서드(예: 요소가 브라우저 DOM에 추가된 후). 모든 ElementReference 필드는 실행될 때까지 채워집니다. 이 메서드는 사전 렌더링 또는 서버 쪽 렌더링 중에 호출되지 않습니다. 이러한 프로세스는 라이브 브라우저 DOM에 연결되지 않고 DOM이 업데이트되기 전에 이미 완료되었기 때문입니다. 이 경우 무한 렌더링 루프가 발생하므로 반환 Task된 항목이 완료된 후에는 구성 요소가 자동으로 다시 렌더링되지 않습니다. |
| OnInitialized() |
렌더링 트리의 부모로부터 초기 매개 변수를 수신하여 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다. (다음에서 상속됨 ComponentBase) |
| OnInitializedAsync() |
렌더링 트리의 부모로부터 초기 매개 변수를 수신하여 구성 요소를 시작할 준비가 되면 호출되는 메서드입니다. 비동기 작업을 수행하고 해당 작업이 완료될 때 구성 요소를 새로 고치려는 경우 이 메서드를 재정의합니다. (다음에서 상속됨 ComponentBase) |
| OnParametersSet() |
구성 요소가 렌더링 트리에서 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다. (다음에서 상속됨 ComponentBase) |
| OnParametersSetAsync() |
구성 요소가 렌더링 트리에서 부모로부터 매개 변수를 수신하고 들어오는 값이 속성에 할당되었을 때 호출되는 메서드입니다. |
| RefreshDataAsync() |
제공된 데이터 원본(또는 ItemsItemsProvider)에서 현재 데이터를 다시 가져오고 렌더링하도록 그리드에 지시합니다. |
| SetParametersAsync(ParameterView) |
렌더링 트리에서 구성 요소의 부모가 제공하는 매개 변수를 설정합니다. (다음에서 상속됨 ComponentBase) |
| ShouldRender() |
구성 요소가 렌더링되어야 하는지 여부를 나타내는 플래그를 반환합니다. (다음에서 상속됨 ComponentBase) |
| ShowColumnOptionsAsync(ColumnBase<TGridItem>) |
지정된 열의 ColumnOptions UI를 표시하여 이전에 표시된 다른 열 옵션 UI를 닫습니다. |
| SortByColumnAsync(ColumnBase<TGridItem>, SortDirection) |
표의 현재 정렬 열을 지정된 |
| StateHasChanged() |
구성 요소에 상태가 변경되었음을 알 수 있습니다. 해당하는 경우 구성 요소가 다시 렌더링됩니다. (다음에서 상속됨 ComponentBase) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| IComponent.Attach(RenderHandle) |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |
| IHandleAfterRender.OnAfterRenderAsync() |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |
| IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object) |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |