VirtualizingLayoutContext.GetOrCreateElementAt 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

多載

名稱	Description
GetOrCreateElementAt(Int32)	取得代表來源中指定索引資料項目的 UIElement。 預設情況下，如果元素已經存在，則會回傳該元素;否則，會產生新的元素。
GetOrCreateElementAt(Int32, ElementRealizationOptions)	取得一個 UIElement，該 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（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

一個代表資料項目的 UIElement。

屬性

OverloadAttribute

備註

此方法呼叫 GetOrCreateElementAtCore（System.Int32，Microsoft.UI。Xaml.Controls.ElementRealizationOptions）必須在衍生類別中實作。

當你為指定索引請求元素時，可以選擇性地指定是抑制自動回收該元素，或強制建立新元素。 自動回收抑制（SuppressAutoRecycle）後回收的元素，會被自動回收邏輯忽略，該邏輯會清除未作為當前佈局流程一部分回收的已實現元素。 你必須明確回收這些元素，透過傳入 RecycleElement 方法來避免記憶體洩漏。

這些選項是針對較進階的佈局設計，明確管理元素的實現與回收，作為效能優化。