VirtualizingLayoutContext.GetOrCreateElementAt 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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。
- 属性
注解
此方法调用 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。
- 属性
注解
此方法调用 GetOrCreateElementAtCore (System.Int32、Microsoft.UI.Xaml.Controls.ElementRealizationOptions) （必须在派生类中实现）。
请求指定索引的元素时，可以选择指定是禁止自动回收检索的元素还是强制创建新元素。 使用自动回收取消检索的元素 (SuppressAutoRecycle) 将被自动回收逻辑忽略，该逻辑清除未作为当前布局传递的一部分检索的已实现元素。 必须通过将这些元素传递给 RecycleElement 方法来显式回收这些元素，以避免内存泄漏。
这些选项适用于更高级的布局，这些布局选择显式管理元素的实现和回收作为性能优化。