VirtualizingLayoutContext.GetOrCreateElementAt 方法

定义

命名空间:

Microsoft.UI.Xaml.Controls

重载

GetOrCreateElementAt(Int32)	检索表示在指定索引处找到的源中的数据项的 UIElement。 默认情况下，如果元素已存在，则返回该元素;否则，将创建一个新元素。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。
GetOrCreateElementAt(Int32, ElementRealizationOptions)	检索表示使用指定选项在指定索引处找到的源中的数据项的 UIElement。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。

GetOrCreateElementAt(Int32)

检索表示在指定索引处找到的源中的数据项的 UIElement。 默认情况下，如果元素已存在，则返回该元素;否则，将创建一个新元素。

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

public:
 virtual UIElement ^ GetOrCreateElementAt(int index) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
UIElement GetOrCreateElementAt(int const& index);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
public UIElement GetOrCreateElementAt(int index);

Public Function GetOrCreateElementAt (index As Integer) As UIElement

参数

index

Int32

int

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

返回

UIElement

表示数据项的 UIElement。

属性

OverloadAttribute

注解

此方法调用 GetOrCreateElementAtCore (System.Int32，Microsoft.UI.Xaml.Controls.ElementRealizationOptions) ，选项设置为 None。

GetElementAtCore 必须在派生类中实现。

GetOrCreateElementAt(Int32, ElementRealizationOptions)

检索表示使用指定选项在指定索引处找到的源中的数据项的 UIElement。

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

public:
 virtual UIElement ^ GetOrCreateElementAt(int index, ElementRealizationOptions options) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
UIElement GetOrCreateElementAt(int const& index, ElementRealizationOptions const& options);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
public UIElement GetOrCreateElementAt(int index, ElementRealizationOptions options);

Public Function GetOrCreateElementAt (index As Integer, options As ElementRealizationOptions) As UIElement

参数

index

Int32

int

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

options

ElementRealizationOptions

ElementRealizationOptions 的值，该值指定是禁止自动回收检索的元素还是强制创建新元素。

返回

UIElement

表示数据项的 UIElement。

属性

OverloadAttribute

注解

此方法调用 GetOrCreateElementAtCore (System.Int32、Microsoft.UI.Xaml.Controls.ElementRealizationOptions) （必须在派生类中实现）。

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

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