Virtualize<TItem> 类

定义

命名空间:

Microsoft.AspNetCore.Components.Web.Virtualization

程序集:

Microsoft.AspNetCore.Components.Web.dll

包:

Microsoft.AspNetCore.Components.Web v8.0.0

提供用于呈现项的虚拟化列表的功能。

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要呈现的项的类型。

继承

Object

ComponentBase

Virtualize<TItem>

实现

IAsyncDisposable

构造函数

Virtualize<TItem>()

提供用于呈现项的虚拟化列表的功能。

属性

ChildContent	获取或设置列表的项模板。
EmptyContent	获取或设置当 为空或 为零时ItemsTotalItemCount要显示的内容。
ItemContent	获取或设置列表的项模板。
Items	获取或设置固定项源。
ItemSize	获取每个项的大小（以像素为单位）。 默认为 50px。
ItemsProvider	获取或设置向列表提供项的函数。
OverscanCount	获取或设置一个值，该值确定将在可见区域之前和之后呈现多少个附加项。 这有助于降低滚动期间呈现的频率。 但是，较高的值意味着页面中将存在更多的元素。
Placeholder	获取或设置尚未在内存中加载的项的模板。
SpacerElement	获取或设置将用作虚拟化分隔符的 HTML 元素的标记名称。 一个这样的元素将呈现在可见项之前，并在它们之后呈现一个，使用显式的“高度”样式来控制滚动范围。 默认值为“div”。 如果要将 Virtualize<TItem> 实例放置在需要特定子标记名称的元素内，请考虑在此处设置该名称。 例如，在“tbody”内呈现时，请考虑将 设置为 SpacerElement 值“tr”。

方法

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)