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 sich am angegebenen Index befindet. Wenn ein Element bereits vorhanden ist, wird es standardmäßig zurückgegeben. andernfalls wird ein neues Element erstellt.
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Ruft mithilfe der angegebenen Optionen ein UIElement ab, das das Datenelement in der Quelle darstellt, die sich am angegebenen Index befindet.

GetOrCreateElementAt(Int32)

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

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

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) auf, wobei die Optionen auf None festgelegt sind.

GetElementAtCore muss in einer abgeleiteten Klasse implementiert werden.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Ruft mithilfe der angegebenen Optionen ein UIElement ab, das das Datenelement in der Quelle darstellt, die sich am angegebenen Index befindet.

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

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 unterdrückt oder die Erstellung eines neuen Elements erzwungen 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 (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 RecycleElement-Methode übergeben, um Speicherverluste zu vermeiden.

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