VirtualizingLayoutContext.GetOrCreateElementAt 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

多載

GetOrCreateElementAt(Int32)	擷取 UIElement，代表在指定索引處找到之來源中的數據項。 根據預設，如果項目已經存在，則會傳回它;否則，會建立新的專案。
GetOrCreateElementAt(Int32, ElementRealizationOptions)	擷取 UIElement，代表使用指定選項在指定索引中找到之來源中的數據項。

GetOrCreateElementAt(Int32)

擷取 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 GetOrCreateElementAtCore（System.Int32，Microsoft.UI.Xaml.Controls.ElementRealizationOptions），並將選項設定為 None。

GetElementAtCore 必須在衍生類別中實作。

GetOrCreateElementAt(Int32, ElementRealizationOptions)

擷取 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 方法來明確回收這些專案，以避免記憶體流失。

這些選項適用於更進階的版面配置，這些配置會選擇明確管理元素的實現和回收，作為效能優化。