VirtualizingLayoutContext.GetOrCreateElementAt 方法

定义

命名空间:

Microsoft.UI.Xaml.Controls

重载

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

GetOrCreateElementAt(Int32)

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

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);

function getOrCreateElementAt(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，该 UIElement 表示使用指定选项在指定索引处找到的源中的数据项。

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);

function getOrCreateElementAt(index, 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 方法来显式回收这些元素，以避免内存泄漏。

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