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
표의 각 행이 나타내는 데이터 형식입니다.
- 상속
- 특성
- 구현
생성자
QuickGrid<TGridItem>() |
QuickGrid<TGridItem>인스턴스를 생성합니다. |
속성
AdditionalAttributes |
만든 요소에 적용할 추가 특성의 컬렉션을 가져오거나 설정합니다. |
Assets |
애플리케이션에 대한 ResourceAssetCollection 가져옵니다. (다음에서 상속됨 ComponentBase) |
AssignedRenderMode |
이 구성 요소에 할당된 IComponentRenderMode 가져옵니다. (다음에서 상속됨 ComponentBase) |
ChildContent |
이 인스턴스의 자식 구성 요소를 정의합니다. 예를 들어 ColumnBase<TGridItem> 기본 클래스에서 파생된 구성 요소를 추가하여 열을 정의할 수 있습니다. |
Class |
선택적 CSS 클래스 이름입니다. 지정된 경우 렌더링된 테이블의 클래스 특성에 포함됩니다. |
ItemKey |
필요에 따라 렌더링된 각 행에서 @key 값을 정의합니다. 일반적으로 각 데이터 항목에 대해 기본 키 값과 같은 고유 식별자를 지정하는 데 사용해야 합니다. 이렇게 하면 TGridItem 인스턴스가 새 복사본으로 대체되는 경우에도(예: 기본 데이터 저장소에 대한 새 쿼리 후) 행 요소와 데이터 항목 간의 연결을 고유 식별자에 따라 유지할 수 있습니다. 설정하지 않으면 @key TGridItem 인스턴스 자체가 됩니다. |
Items |
그리드에 대한 쿼리 가능한 데이터 원본입니다. 이는 AsQueryable(IEnumerable) 확장 메서드 또는 EntityFramework DataSet 또는 파생된 IQueryable 사용하여 쿼리 가능으로 변환된 메모리 내 데이터일 수 있습니다. Items 또는 ItemsProvider제공해야 하지만 둘 다 제공하지는 않습니다. |
ItemSize |
이는 Virtualize사용하는 경우에만 적용됩니다. 각 행에 대해 예상 높이를 픽셀 단위로 정의하여 가상화 메커니즘이 표시 크기와 일치하고 정확한 스크롤을 보장하기 위해 올바른 수의 항목을 가져올 수 있도록 합니다. |
ItemsProvider |
그리드에 대한 데이터를 제공하는 콜백입니다. Items 또는 ItemsProvider제공해야 하지만 둘 다 제공하지는 않습니다. |
OverscanCount |
이는 Virtualize사용하는 경우에만 적용됩니다. 스크롤하는 동안 렌더링 빈도를 줄이기 위해 표시되는 영역 전후에 렌더링할 추가 항목 수를 정의합니다. 값이 높을수록 화면에서 더 많은 항목을 렌더링하여 스크롤 부드러움을 향상시킬 수 있지만 초기 로드 시간을 늘릴 수도 있습니다. 데이터 세트 크기 및 사용자 환경 요구 사항에 따라 균형을 찾는 것이 좋습니다. 기본값은 3입니다. |
Pagination |
필요에 따라 이 QuickGrid<TGridItem> 인스턴스를 PaginationState 모델에 연결하여 그리드가 데이터의 현재 페이지만 가져오고 렌더링합니다. 일반적으로 제공된 PaginationState 인스턴스를 표시하고 업데이트하는 Paginator 구성 요소 또는 다른 UI 논리와 함께 사용됩니다. |
RendererInfo |
구성 요소가 실행되는 RendererInfo 가져옵니다. (다음에서 상속됨 ComponentBase) |
Theme |
기본값이 "default"인 테마 이름입니다. 이는 테이블과 일치하는 스타일 지정 규칙에 영향을 줍니다. |
Virtualize |
true이면 그리드가 가상화로 렌더링됩니다. 일반적으로 스크롤과 함께 사용되며 그리드가 현재 스크롤 뷰포트 주위의 데이터만 가져오고 렌더링합니다. 이렇게 하면 큰 데이터 집합을 스크롤할 때 성능이 크게 향상될 수 있습니다. Virtualize사용하는 경우 ItemSize 값을 제공해야 하며 모든 행이 동일한 상수 높이로 렌더링되도록 해야 합니다. 일반적으로 렌더링되는 데이터의 양이 작거나 페이지 매김을 사용하는 경우 Virtualize 사용하지 않는 것이 좋습니다. |
메서드
BuildRenderTree(RenderTreeBuilder) |
그리드를 표시하는 구성 요소입니다. |
DispatchExceptionAsync(Exception) |
제공된 이는 구성 요소 수명 주기 메서드 외부에서 예외가 발생하지만 구성 요소 수명 주기 메서드의 예외와 동일하게 처리하려는 경우에 유용합니다. (다음에서 상속됨 ComponentBase) |
DisposeAsync() |
그리드를 표시하는 구성 요소입니다. |
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() |
제공된 데이터 원본(Items 또는 ItemsProvider)에서 현재 데이터를 다시 가져오고 렌더링하도록 그리드에 지시합니다. |
SetParametersAsync(ParameterView) |
렌더링 트리에서 구성 요소의 부모가 제공하는 매개 변수를 설정합니다. (다음에서 상속됨 ComponentBase) |
ShouldRender() |
구성 요소가 렌더링되어야 하는지 여부를 나타내는 플래그를 반환합니다. (다음에서 상속됨 ComponentBase) |
ShowColumnOptionsAsync(ColumnBase<TGridItem>) |
지정한 열에 대한 ColumnOptions UI를 표시하여 이전에 표시된 다른 열 옵션 UI를 닫습니다. |
SortByColumnAsync(ColumnBase<TGridItem>, SortDirection) |
표의 현재 정렬 열을 지정된 |
StateHasChanged() |
구성 요소에 상태가 변경되었음을 알 수 있습니다. 해당하는 경우 구성 요소가 다시 렌더링됩니다. (다음에서 상속됨 ComponentBase) |
명시적 인터페이스 구현
IComponent.Attach(RenderHandle) |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |
IHandleAfterRender.OnAfterRenderAsync() |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object) |
그리드를 표시하는 구성 요소입니다. (다음에서 상속됨 ComponentBase) |