VirtualizingLayoutContext.GetOrCreateElementAt 方法

定義

命名空間:

Microsoft.UI.Xaml.Controls

多載

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

表示資料項目的 UIElement。

屬性

OverloadAttribute

備註

此方法會呼叫 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

表示資料項目的 UIElement。

屬性

OverloadAttribute

備註

這個方法會呼叫 GetOrCreateElementAtCore (System.Int32，Microsoft.UI.Xaml.Controls.ElementRealizationOptions) ，這必須在衍生類別中實作。

當您要求指定索引的專案時，您可以選擇性地指定是否要隱藏擷取專案的自動回收，還是強制建立新元素。 自動回收所擷取的元素會隱藏 (SuppressAutoRecycle) 會被自動回收邏輯忽略，以清除未擷取為目前版面設定階段一部分的實現專案。 您必須將這些專案傳遞至 RecycleElement 方法來明確回收這些專案，以避免記憶體流失。

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