VirtualizingLayoutContext.GetOrCreateElementAtCore 方法

定义

在派生类中实现时,使用指定选项检索表示源中指定索引处的数据项的 UIElement

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI,请参阅) Windows 应用 SDK命名空间

protected:
 virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;
UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);
protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);
Protected Overridable Function GetOrCreateElementAtCore (index As Integer, options As ElementRealizationOptions) As UIElement

参数

index
Int32

int

要为其检索 UIElement 的数据项的索引。

options
ElementRealizationOptions

指定是禁止自动回收检索到的元素,还是强制创建新元素。

返回

表示数据项的 UIElement

注解

此方法由 GetOrCreateElementAt (System.Int32) GetOrCreateElementAt (System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) 调用。

为指定索引请求元素时,可以选择性地指定是禁止自动回收检索到的元素,还是强制创建新元素。 自动回收逻辑会忽略使用自动回收取消 (SuppressAutoRecycle) 检索的元素,该逻辑清除未作为当前布局传递的一部分检索的已实现的元素。 必须通过将这些元素传递给 RecycleElementCore (Windows.UI.Xaml.UIElement) 方法来显式回收这些元素,以避免内存泄漏。

这些选项适用于更高级的布局,这些布局选择显式管理元素的实现和回收作为性能优化。

适用于