Virtualize<TItem> Klasa

Definicja

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

generic <typename TItem>
public ref class Virtualize sealed : Microsoft::AspNetCore::Components::ComponentBase, IAsyncDisposable
public sealed class Virtualize<TItem> : Microsoft.AspNetCore.Components.ComponentBase, IAsyncDisposable
type Virtualize<'Item> = class
    inherit ComponentBase
    interface IAsyncDisposable
Public NotInheritable Class Virtualize(Of TItem)
Inherits ComponentBase
Implements IAsyncDisposable

Parametry typu

TItem

Typ context renderowanych elementów.

Dziedziczenie
Virtualize<TItem>
Implementuje

Konstruktory

Nazwa Opis
Virtualize<TItem>()

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

Właściwości

Nazwa Opis
Assets

Pobiera element ResourceAssetCollection dla aplikacji.

(Odziedziczone po ComponentBase)
AssignedRenderMode

Pobiera przypisaną IComponentRenderMode do tego składnika.

(Odziedziczone po ComponentBase)
ChildContent

Pobiera lub ustawia szablon elementu dla listy. Zobacz: ItemContent.

EmptyContent

Pobiera lub ustawia zawartość, która ma być wyświetlana, gdy Items jest pusta lub gdy ma TotalItemCount wartość zero.

ItemContent

Pobiera lub ustawia szablon elementu dla listy.

Items

Pobiera lub ustawia źródło stałego elementu.

ItemSize

Pobiera rozmiar każdego elementu w pikselach. Wartość domyślna to 50 pikseli.

ItemsProvider

Pobiera lub ustawia funkcję dostarczającą elementy do listy.

MaxItemCount

Pobiera lub ustawia maksymalną liczbę elementów, które będą renderowane, nawet jeśli klient zgłasza, że jego port widoków jest wystarczająco duży, aby pokazać więcej. Wartość domyślna to 100.

Powinno to być używane tylko jako zabezpieczenie przed nadmiernym użyciem pamięci lub dużymi obciążeniami danych. Nie należy ustawiać tej wartości na mniejszą liczbę niż oczekiwano w realistycznym oknie, ponieważ spowoduje to pozostawienie pustej luki poniżej, a użytkownik może nie być w stanie wyświetlić pozostałej części zawartości.

OverscanCount

Pobiera lub ustawia wartość, która określa, ile dodatkowych elementów będzie renderowanych przed i po widocznym regionie. Pomaga to zmniejszyć częstotliwość renderowania podczas przewijania. Jednak wyższe wartości oznaczają, że więcej elementów będzie obecnych na stronie.

Placeholder

Pobiera lub ustawia szablon dla elementów, które nie zostały jeszcze załadowane w pamięci.

RendererInfo

RendererInfo Pobiera składnik, na którym jest uruchomiony.

(Odziedziczone po ComponentBase)
SpacerElement

Pobiera lub ustawia nazwę tagu elementu HTML, który będzie używany jako spacer wirtualizacji. Jeden z takich elementów zostanie renderowany przed widocznymi elementami i jeszcze jeden po nim, używając jawnego stylu "height" do sterowania zakresem przewijania.

Wartość domyślna to "div". Jeśli umieszczasz Virtualize<TItem> wystąpienie wewnątrz elementu, który wymaga określonej nazwy tagu podrzędnego, rozważ ustawienie w tym miejscu. Na przykład podczas renderowania wewnątrz elementu "tbody" rozważ ustawienie SpacerElement wartości "tr".

Metody

Nazwa Opis
BuildRenderTree(RenderTreeBuilder)

Renderuje składnik do dostarczonego RenderTreeBuilderelementu .

(Odziedziczone po ComponentBase)
DispatchExceptionAsync(Exception)

Traktuje dostarczony element exception jako zgłaszany 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()

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

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 ElementReference pola 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 ElementReference pola 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 Taskpo zakończeniu żadnego zwróconego elementu , ponieważ spowodowałoby to nieskończoną pętlę renderowania.

(Odziedziczone po ComponentBase)
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.

(Odziedziczone po ComponentBase)
RefreshDataAsync()

Nakazuje składnikowi ponowne żądanie danych z jego ItemsProviderelementu . Jest to przydatne, jeśli dane zewnętrzne mogły ulec zmianie. Nie ma potrzeby wywoływania tej funkcji w przypadku korzystania z polecenia Items.

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

Nazwa Opis
IComponent.Attach(RenderHandle)

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

(Odziedziczone po ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

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

Udostępnia funkcje renderowania zwirtualizowanej listy elementów.

(Odziedziczone po ComponentBase)

Dotyczy