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