VirtualizingLayoutContext.GetOrCreateElementAtCore 方法

定义

命名空间:

Microsoft.UI.Xaml.Controls

在派生类中实现时，使用指定选项检索表示源中指定索引处的数据项的 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

表示数据项的 UIElement 。

注解

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

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

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