Udostępnij za pośrednictwem


QuickGrid<TGridItem> Klasa

Definicja

Składnik, który wyświetla siatkę.

[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

Parametry typu

TGridItem

Typ danych reprezentowanych przez każdy wiersz w siatce.

Dziedziczenie
QuickGrid<TGridItem>
Atrybuty
Implementuje

Konstruktory

QuickGrid<TGridItem>()

Tworzy wystąpienie QuickGrid<TGridItem>.

Właściwości

AdditionalAttributes

Pobiera lub ustawia kolekcję dodatkowych atrybutów, które zostaną zastosowane do utworzonego elementu.

Assets

Pobiera ResourceAssetCollection dla aplikacji.

(Odziedziczone po ComponentBase)
AssignedRenderMode

Pobiera IComponentRenderMode przypisane do tego składnika.

(Odziedziczone po ComponentBase)
ChildContent

Definiuje składniki podrzędne tego wystąpienia. Można na przykład zdefiniować kolumny, dodając składniki pochodzące z klasy bazowej ColumnBase<TGridItem>.

Class

Opcjonalna nazwa klasy CSS. Jeśli zostanie podana, zostanie ona uwzględniona w atrybucie klasy renderowanej tabeli.

ItemKey

Opcjonalnie definiuje wartość @key dla każdego renderowanego wiersza. Zazwyczaj należy go użyć do określenia unikatowego identyfikatora, takiego jak wartość klucza podstawowego, dla każdego elementu danych.

Dzięki temu siatka może zachować skojarzenie między elementami wiersza i elementami danych na podstawie ich unikatowych identyfikatorów, nawet gdy wystąpienia TGridItem są zastępowane przez nowe kopie (na przykład po nowym zapytaniu względem bazowego magazynu danych).

Jeśli nie zostanie ustawiona, @key będzie samym wystąpieniem TGridItem.

Items

Możliwe do wykonywania zapytania źródło danych dla siatki.

Mogą to być dane w pamięci konwertowane na dane możliwe do wykonywania zapytań przy użyciu metody rozszerzenia AsQueryable(IEnumerable) lub zestawu danych EntityFramework albo IQueryable pochodnego.

Należy podać Items lub ItemsProvider, ale nie oba.

ItemSize

Ma to zastosowanie tylko w przypadku używania Virtualize. Definiuje ona oczekiwaną wysokość w pikselach dla każdego wiersza, umożliwiając mechanizmowi wirtualizacji pobranie prawidłowej liczby elementów odpowiadających rozmiarowi wyświetlania i zapewnienie dokładnego przewijania.

ItemsProvider

Wywołanie zwrotne, które dostarcza dane dla siatki.

Należy podać Items lub ItemsProvider, ale nie oba.

OverscanCount

Ma to zastosowanie tylko w przypadku używania Virtualize. Definiuje liczbę dodatkowych elementów renderowanych przed i po widocznym regionie w celu zmniejszenia częstotliwości renderowania podczas przewijania. Chociaż wyższe wartości mogą poprawić płynność przewijania przez renderowanie większej liczby elementów poza ekranem, mogą również zwiększyć początkowy czas ładowania. Zalecane jest znalezienie równowagi na podstawie rozmiaru zestawu danych i wymagań dotyczących środowiska użytkownika. Wartość domyślna to 3.

Pagination

Opcjonalnie łączy to wystąpienie QuickGrid<TGridItem> z modelem PaginationState, co powoduje pobranie siatki i renderowanie tylko bieżącej strony danych.

Jest to zwykle używane w połączeniu ze składnikiem Paginator lub inną logiką interfejsu użytkownika, która wyświetla i aktualizuje podane wystąpienie PaginationState.

RendererInfo

Pobiera RendererInfo składnik jest uruchomiony.

(Odziedziczone po ComponentBase)
Theme

Nazwa motywu z wartością domyślną "default". Ma to wpływ na reguły stylów zgodne z tabelą.

Virtualize

Jeśli wartość true, siatka zostanie wyrenderowana z wirtualizacją. Jest to zwykle używane w połączeniu z przewijaniem i powoduje pobranie siatki i renderowanie tylko danych wokół bieżącego widoku przewijania. Może to znacznie poprawić wydajność podczas przewijania dużych zestawów danych.

Jeśli używasz Virtualize, należy podać wartość dla ItemSize i upewnić się, że każdy wiersz jest renderowany z taką samą stałą wysokością.

Ogólnie rzecz biorąc zaleca się, aby nie używać Virtualize, jeśli ilość renderowanych danych jest niewielka lub jeśli używasz stronicowania.

Metody

BuildRenderTree(RenderTreeBuilder)

Składnik, który wyświetla siatkę.

DispatchExceptionAsync(Exception)

Traktuje dostarczone exception jako zgłaszane przez ten składnik. Spowoduje to przejście otaczającego elementu ErrorBoundary do stanu niepowodzenia. Jeśli nie ma otaczającego elementu ErrorBoundary, zostanie on uznany za wyjątek od otaczającego modułu renderowania.

Jest to przydatne, jeśli wyjątek występuje poza metodami cyklu życia składnika, ale chcesz traktować go tak samo jak wyjątek od metody cyklu życia składnika.

(Odziedziczone po ComponentBase)
DisposeAsync()

Składnik, który wyświetla siatkę.

InvokeAsync(Action)

Wykonuje podany element roboczy w kontekście synchronizacji skojarzonego modułu renderowania.

(Odziedziczone po ComponentBase)
InvokeAsync(Func<Task>)

Wykonuje podany element roboczy w kontekście synchronizacji skojarzonego modułu renderowania.

(Odziedziczone po ComponentBase)
OnAfterRender(Boolean)

Metoda wywoływana po każdym renderowaniu składnika interaktywnie i zakończeniu aktualizacji interfejsu użytkownika (na przykład po dodaniu elementów do przeglądarki DOM). Wszystkie pola ElementReference zostaną wypełnione przez czas wykonywania tego uruchomienia.

Ta metoda nie jest wywoływana podczas renderowania wstępnego ani renderowania po stronie serwera, ponieważ te procesy nie są dołączone do żadnego modelu DOM przeglądarki na żywo i zostały już ukończone przed zaktualizowanym modelem DOM.

(Odziedziczone po ComponentBase)
OnAfterRenderAsync(Boolean)

Metoda wywoływana po każdym renderowaniu składnika interaktywnie, a interfejs użytkownika zakończył aktualizowanie (na przykład po dodaniu elementów do przeglądarki DOM). Wszystkie pola ElementReference zostaną wypełnione przez czas wykonywania tego uruchomienia.

Ta metoda nie jest wywoływana podczas renderowania wstępnego ani renderowania po stronie serwera, ponieważ te procesy nie są dołączone do żadnego modelu DOM przeglądarki na żywo i zostały już ukończone przed zaktualizowanym modelem DOM.

Należy pamiętać, że składnik nie jest automatycznie ponownie renderowany po zakończeniu żadnego zwróconego Task, ponieważ spowodowałoby to nieskończoną pętlę renderowania.

OnInitialized()

Metoda wywoływana, gdy składnik jest gotowy do uruchomienia, po otrzymaniu jego początkowych parametrów z elementu nadrzędnego w drzewie renderowania.

(Odziedziczone po ComponentBase)
OnInitializedAsync()

Metoda wywoływana, gdy składnik jest gotowy do uruchomienia, po otrzymaniu jego początkowych parametrów z elementu nadrzędnego w drzewie renderowania.

Zastąpi tę metodę, jeśli wykonasz operację asynchroniczną i chcesz odświeżyć składnik po zakończeniu tej operacji.

(Odziedziczone po ComponentBase)
OnParametersSet()

Metoda wywoływana, gdy składnik otrzymał parametry od elementu nadrzędnego w drzewie renderowania, a wartości przychodzące zostały przypisane do właściwości.

(Odziedziczone po ComponentBase)
OnParametersSetAsync()

Metoda wywoływana, gdy składnik otrzymał parametry od elementu nadrzędnego w drzewie renderowania, a wartości przychodzące zostały przypisane do właściwości.

RefreshDataAsync()

Instruuje siatkę, aby ponownie pobrać i renderować bieżące dane z dostarczonego źródła danych (Items lub ItemsProvider).

SetParametersAsync(ParameterView)

Ustawia parametry dostarczane przez element nadrzędny składnika w drzewie renderowania.

(Odziedziczone po ComponentBase)
ShouldRender()

Zwraca flagę wskazującą, czy składnik powinien być renderowany.

(Odziedziczone po ComponentBase)
ShowColumnOptionsAsync(ColumnBase<TGridItem>)

Wyświetla interfejs użytkownika ColumnOptions dla określonej kolumny, zamykając dowolny inny interfejs użytkownika opcji kolumny, który był wcześniej wyświetlany.

SortByColumnAsync(ColumnBase<TGridItem>, SortDirection)

Ustawia bieżącą kolumnę sortowania siatki na określoną column.

StateHasChanged()

Powiadamia składnik, że jego stan uległ zmianie. Jeśli ma to zastosowanie, spowoduje to ponowne renderowanie składnika.

(Odziedziczone po ComponentBase)

Jawne implementacje interfejsu

IComponent.Attach(RenderHandle)

Składnik, który wyświetla siatkę.

(Odziedziczone po ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Składnik, który wyświetla siatkę.

(Odziedziczone po ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

Składnik, który wyświetla siatkę.

(Odziedziczone po ComponentBase)

Dotyczy