Virtualize<TItem> クラス

定義

項目の仮想化されたリストをレンダリングするための機能を提供します。

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

型パラメーター

TItem

contextレンダリングされる項目の型。

継承
Virtualize<TItem>
実装

コンストラクター

Virtualize<TItem>()

項目の仮想化されたリストをレンダリングするための機能を提供します。

プロパティ

ChildContent

リストの項目テンプレートを取得または設定します。

EmptyContent

が空の場合、または が 0 の場合 Items に表示するコンテンツを TotalItemCount 取得または設定します。

ItemContent

リストの項目テンプレートを取得または設定します。

Items

固定項目のソースを取得または設定します。

ItemSize

各項目のサイズをピクセル単位で取得します。 既定値は 50px です。

ItemsProvider

リストに項目を提供する関数を取得または設定します。

OverscanCount

表示領域の前後にレンダリングされる追加項目の数を決定する値を取得または設定します。 これは、スクロール中のレンダリングの頻度を減らすのに役立ちます。 ただし、値が大きいほど、ページに存在する要素が多くなります。

Placeholder

メモリにまだ読み込まれていない項目のテンプレートを取得または設定します。

SpacerElement

仮想化スペーサーとして使用される HTML 要素のタグ名を取得または設定します。 このような要素の 1 つは、表示されている項目の前にレンダリングされ、もう 1 つはスクロール範囲を制御するために明示的な "高さ" スタイルを使用してレンダリングされます。

既定値は "div" です。 特定の子タグ名を Virtualize<TItem> 必要とする要素内にインスタンスを配置する場合は、ここで設定することを検討してください。 たとえば、"tbody" 内でレンダリングする場合は、値 "tr" に設定 SpacerElement することを検討してください。

メソッド

BuildRenderTree(RenderTreeBuilder)

コンポーネントを指定された RenderTreeBuilderにレンダリングします。

(継承元 ComponentBase)
DispatchExceptionAsync(Exception)

指定された exception を、このコンポーネントによってスローされると見なします。 これにより、外側の 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の完了後に自動的に再レンダリングされないことに注意してください。これは、無限のレンダリング ループが発生するためです。

(継承元 ComponentBase)
OnInitialized()

コンポーネントが起動する準備ができたときに呼び出されるメソッド。レンダリング ツリー内の親から初期パラメーターを受け取ります。

(継承元 ComponentBase)
OnInitializedAsync()

コンポーネントが起動する準備ができたときに呼び出されるメソッド。レンダリング ツリー内の親から初期パラメーターを受け取ります。

非同期操作を実行し、その操作が完了したときにコンポーネントを更新する場合は、このメソッドをオーバーライドします。

(継承元 ComponentBase)
OnParametersSet()

コンポーネントがレンダー ツリー内の親からパラメーターを受け取り、受信値がプロパティに割り当てられているときに呼び出されるメソッド。

(継承元 ComponentBase)
OnParametersSetAsync()

コンポーネントがレンダー ツリー内の親からパラメーターを受け取り、受信値がプロパティに割り当てられているときに呼び出されるメソッド。

(継承元 ComponentBase)
RefreshDataAsync()

コンポーネントからデータ ItemsProviderを要求し直すように指示します。 これは、外部データが変更された可能性がある場合に便利です。 を使用 Itemsする場合は、これを呼び出す必要はありません。

SetParametersAsync(ParameterView)

レンダリング ツリー内のコンポーネントの親によって提供されるパラメーターを設定します。

(継承元 ComponentBase)
ShouldRender()

コンポーネントをレンダリングするかどうかを示すフラグを返します。

(継承元 ComponentBase)
StateHasChanged()

状態が変更されたことをコンポーネントに通知します。 必要に応じて、コンポーネントが再レンダリングされます。

(継承元 ComponentBase)

明示的なインターフェイスの実装

IComponent.Attach(RenderHandle)

項目の仮想化されたリストをレンダリングするための機能を提供します。

(継承元 ComponentBase)
IHandleAfterRender.OnAfterRenderAsync()

項目の仮想化されたリストをレンダリングするための機能を提供します。

(継承元 ComponentBase)
IHandleEvent.HandleEventAsync(EventCallbackWorkItem, Object)

項目の仮想化されたリストをレンダリングするための機能を提供します。

(継承元 ComponentBase)

適用対象