VirtualizingLayoutContext.GetOrCreateElementAtCore Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Lorsqu’il est implémenté dans une classe dérivée, récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié à l’aide des options spécifiées.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

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

Paramètres

index

Int32

int

Index de l’élément de données pour lequel récupérer un UIElement .

options

ElementRealizationOptions

Spécifie s’il faut supprimer le recyclage automatique de l’élément récupéré ou forcer la création d’un nouvel élément.

Retours

UIElement

UIElement qui représente l’élément de données.

Remarques

Cette méthode est appelée par GetOrCreateElementAt(System.Int32) et GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions).

Lorsque vous demandez un élément pour l’index spécifié, vous pouvez éventuellement spécifier s’il faut supprimer le recyclage automatique de l’élément récupéré ou forcer la création d’un nouvel élément. Les éléments récupérés avec le recyclage automatique supprimé (SuppressAutoRecycle) sont ignorés par la logique de recyclage automatique qui efface les éléments réalisés qui n’ont pas été récupérés dans le cadre de la passe de disposition actuelle. Vous devez recycler explicitement ces éléments en les transmettant à la méthode RecycleElementCore(Windows.UI.Xaml.UIElement) pour éviter les fuites de mémoire.

Ces options sont destinées aux dispositions plus avancées qui choisissent de gérer explicitement la réalisation et le recyclage des éléments en tant qu’optimisation des performances.