Virtualize<TItem> 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供用于呈现项的虚拟化列表的功能。
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>() |
提供用于呈现项的虚拟化列表的功能。 |
属性
ChildContent |
获取或设置列表的项模板。 |
EmptyContent |
获取或设置当 为空或 为零时ItemsTotalItemCount要显示的内容。 |
ItemContent |
获取或设置列表的项模板。 |
Items |
获取或设置固定项源。 |
ItemSize |
获取每个项的大小(以像素为单位)。 默认为 50px。 |
ItemsProvider |
获取或设置向列表提供项的函数。 |
OverscanCount |
获取或设置一个值,该值确定将在可见区域之前和之后呈现多少个附加项。 这有助于降低滚动期间呈现的频率。 但是,较高的值意味着页面中将存在更多的元素。 |
Placeholder |
获取或设置尚未在内存中加载的项的模板。 |
SpacerElement |
获取或设置将用作虚拟化分隔符的 HTML 元素的标记名称。 一个这样的元素将呈现在可见项之前,并在它们之后呈现一个,使用显式的“高度”样式来控制滚动范围。 默认值为“div”。 如果要将 Virtualize<TItem> 实例放置在需要特定子标记名称的元素内,请考虑在此处设置该名称。 例如,在“tbody”内呈现时,请考虑将 设置为 SpacerElement 值“tr”。 |
方法
BuildRenderTree(RenderTreeBuilder) |
将组件呈现给提供的 RenderTreeBuilder。 (继承自 ComponentBase) |
DispatchExceptionAsync(Exception) |
将提供的 如果异常发生在组件生命周期方法之外,但你希望将其视为组件生命周期方法中的异常,则这非常有用。 (继承自 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) |
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈