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