VirtualizingLayoutContext.GetOrCreateElementAt Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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 UIElementParameter
- index
-
Int32
int
Der Index des Datenelements, für das ein UIElement abgerufen werden soll.
Gibt zurück
Ein UIElement, das das Datenelement darstellt.
- Attribute
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.
Gilt für:
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 UIElementParameter
- 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
Ein UIElement, das das Datenelement darstellt.
- Attribute
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.