QuickGrid<TGridItem> 클래스

정의

그리드를 표시하는 구성 요소입니다.

[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>()

의 instance 생성합니다QuickGrid<TGridItem>.

속성

AdditionalAttributes

만든 요소에 적용할 추가 특성의 컬렉션을 가져오거나 설정합니다.

ChildContent

이 instance 자식 구성 요소를 정의합니다. 예를 들어 기본 클래스에서 파생된 구성 요소를 추가하여 열을 정의할 ColumnBase<TGridItem> 수 있습니다.

Class

선택적 CSS 클래스 이름입니다. 지정된 경우 렌더링된 테이블의 클래스 특성에 포함됩니다.

ItemKey

필요에 따라 렌더링된 각 행에 대한 @key 값을 정의합니다. 일반적으로 각 데이터 항목에 대해 기본 키 값과 같은 고유 식별자를 지정하는 데 사용해야 합니다.

이렇게 하면 TGridItem 인스턴스가 새 복사본으로 대체되는 경우에도(예: 기본 데이터 저장소에 대한 새 쿼리 후) 고유 식별자를 기반으로 행 요소와 데이터 항목 간의 연결을 유지할 수 있습니다.

설정하지 않으면 는 @key TGridItem instance 자체입니다.

Items

그리드에 대한 쿼리 가능한 데이터 원본입니다.

이는 확장 메서드 또는 EntityFramework DataSet 또는 IQueryable 파생된 를 사용하여 AsQueryable(IEnumerable) 쿼리 가능으로 변환된 메모리 내 데이터일 수 있습니다.

또는 중 ItemsProvider하나를 Items 제공해야 하지만 둘 다 제공하지는 않습니다.

ItemSize

이는 를 사용하는 Virtualize경우에만 적용됩니다. 각 행에 대해 예상 높이를 픽셀 단위로 정의하여 가상화 메커니즘이 표시 크기와 일치하고 정확한 스크롤을 보장하기 위해 올바른 수의 항목을 가져올 수 있도록 합니다.

ItemsProvider

rid에 대한 데이터를 제공하는 콜백입니다.

또는 중 ItemsProvider하나를 Items 제공해야 하지만 둘 다 제공하지는 않습니다.

Pagination

필요에 따라 이 QuickGrid<TGridItem> instance 모델과 PaginationState 연결하여 그리드가 현재 데이터 페이지만 가져오고 렌더링합니다.

일반적으로 제공된 PaginationState instance 표시하고 업데이트하는 구성 요소 또는 다른 UI 논리와 함께 Paginator 사용됩니다.

Theme

기본값이 "default"인 테마 이름입니다. 이는 테이블과 일치하는 스타일 규칙에 영향을 줍니다.

Virtualize

true이면 그리드가 가상화로 렌더링됩니다. 일반적으로 스크롤과 함께 사용되며 그리드가 현재 스크롤 뷰포트 주변의 데이터만 가져오고 렌더링합니다. 이렇게 하면 큰 데이터 집합을 스크롤할 때 성능이 크게 향상될 수 있습니다.

를 사용하는 Virtualize경우 에 대한 ItemSize 값을 제공해야 하며 모든 행이 동일한 상수 높이로 렌더링되도록 해야 합니다.

일반적으로 렌더링되는 데이터의 양이 작거나 페이지 매김을 사용하는 경우 사용하지 Virtualize 않는 것이 좋습니다.

메서드

BuildRenderTree(RenderTreeBuilder)

그리드를 표시하는 구성 요소입니다.

DispatchExceptionAsync(Exception)

제공 exception 된 를 이 구성 요소에서 throw되는 것으로 처리합니다. 이로 인해 바깥쪽 ErrorBoundary가 실패 상태로 전환됩니다. 바깥쪽 ErrorBoundary가 없으면 바깥쪽 렌더러의 예외로 간주됩니다.

이는 구성 요소 수명 주기 메서드 외부에서 예외가 발생하지만 구성 요소 수명 주기 메서드의 예외와 동일하게 처리하려는 경우에 유용합니다.

(다음에서 상속됨 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)

표의 현재 정렬 열을 지정된 column로 설정합니다.

StateHasChanged()

구성 요소에 상태가 변경되었음을 알 수 있습니다. 해당하는 경우 구성 요소가 다시 렌더링됩니다.

(다음에서 상속됨 ComponentBase)

명시적 인터페이스 구현

IComponent.Attach(RenderHandle)

그리드를 표시하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

그리드를 표시하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

그리드를 표시하는 구성 요소입니다.

(다음에서 상속됨 ComponentBase)

적용 대상