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, das im angegebenen Index gefunden wurde. Wenn bereits ein Element vorhanden ist, wird es standardmäßig zurückgegeben; andernfalls wird ein neues Element erstellt. |
| GetOrCreateElementAt(Int32, ElementRealizationOptions) |
Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, das im angegebenen Index mithilfe der angegebenen Optionen gefunden wurde. |
GetOrCreateElementAt(Int32)
Ruft ein UIElement ab, das das Datenelement in der Quelle darstellt, das im angegebenen Index gefunden wurde. Wenn bereits ein Element 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 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) auf, wobei Optionen auf Nonefestgelegt sind.
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.
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 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 der Erstellung 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 unterdrückter automatischer Recycling (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 komplexere Layouts vorgesehen, die sich entscheiden, die Realisierung und Das Recycling von Elementen als Leistungsoptimierung explizit zu verwalten.