VirtualizingLayoutContext.GetOrCreateElementAtCore Methode

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft bei der Implementierung in einer abgeleiteten Klasse ein UIElement ab, das das Datenelement in der Quelle darstellt, die im angegebenen Index gefunden wird, indem die angegebenen Optionen verwendet werden.

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

protected:
 virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;

UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);

protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);

Protected Overridable Function GetOrCreateElementAtCore (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

Gibt an, ob das automatische Recycling des abgerufenen Elements unterdrückt oder die Erstellung eines neuen Elements erzwungen werden soll.

Gibt zurück

UIElement

Ein UIElement , das das Datenelement darstellt.

Hinweise

Diese Methode wird von GetOrCreateElementAt(System.Int32) und GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) aufgerufen.

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 (SuppressAutoRecycle) abgerufen werden, 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 RecycleElementCore(Windows.UI.Xaml.UIElement)- Methode übergeben, um Speicherverluste zu vermeiden.

Diese Optionen sind für erweiterte Layouts vorgesehen, bei denen die Realisierung und das Recycling von Elementen als Leistungsoptimierung explizit verwaltet werden sollen.