VirtualizingLayoutContext.GetOrCreateElementAt Methode

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Überlädt

GetOrCreateElementAt(Int32)	Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, die im angegebenen Index gefunden wurde. Wenn ein Element bereits vorhanden ist, wird es standardmäßig zurückgegeben; andernfalls wird ein neues Element erstellt. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe Windows App SDK Namespaces).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, das im angegebenen Index mithilfe der angegebenen Optionen gefunden wurde. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe Windows App SDK Namespaces).

GetOrCreateElementAt(Int32)

Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, die im angegebenen Index gefunden wurde. Wenn ein Element bereits vorhanden ist, wird es standardmäßig zurückgegeben; andernfalls wird ein neues Element erstellt.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe Windows App SDK Namespaces).

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

Parameter

index

Int32

int

Der Index des Datenelements, für das ein UIElement abgerufen werden soll.

Gibt zurück

UIElement

Ein UIElement, das das Datenelement darstellt.

Attribute

OverloadAttribute

Hinweise

Diese Methode ruft GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) mit Optionen auf "None" auf.

GetElementAtCore muss in einer abgeleiteten Klasse implementiert werden.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, das im angegebenen Index mithilfe der angegebenen Optionen gefunden wurde.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK, siehe Windows App SDK Namespaces).

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

Parameter

index

Int32

int

Der Index des Datenelements, für das ein UIElement abgerufen werden soll.

options

ElementRealizationOptions

Ein Wert von ElementRealizationOptions , der angibt, ob das automatische Recycling des abgerufenen Elements oder die Erzwingung eines neuen Elements unterdrückt werden soll.

Gibt zurück

UIElement

Ein UIElement, das das Datenelement darstellt.

Attribute

OverloadAttribute

Hinweise

Diese Methode ruft GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions)auf, die in einer abgeleiteten Klasse implementiert werden muss.

Wenn Sie ein Element für den angegebenen Index anfordern, können Sie optional angeben, ob das automatische Recycling des abgerufenen Elements unterdrückt oder die Erstellung eines neuen Elements erzwungen werden soll. Elemente, die mit dem automatischen Recycling unterdrückt werden (SuppressAutoRecycle) werden von der automatischen Recyclinglogik ignoriert, die realisierte Elemente löscht, die nicht als Teil des aktuellen Layoutdurchlaufs abgerufen wurden. Sie müssen diese Elemente explizit wiederverwenden, indem Sie sie an die RecycleElement-Methode übergeben, um Speicherlecks zu vermeiden.

Diese Optionen sind für erweiterte Layouts vorgesehen, die die Realisierung und das Recycling von Elementen explizit als Leistungsoptimierung verwalten möchten.