VirtualizingLayoutContext.GetOrCreateElementAt Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Surcharges

GetOrCreateElementAt(Int32)	Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié. Par défaut, si un élément existe déjà, il est retourné ; sinon, un nouvel élément est créé. 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).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	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).

GetOrCreateElementAt(Int32)

Récupère un UIElement qui représente l’élément de données dans la source trouvée à l’index spécifié. Par défaut, si un élément existe déjà, il est retourné ; sinon, un nouvel élément est créé.

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).

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 UIElement

Paramètres

index

Int32

int

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

Retours

UIElement

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

Attributs

OverloadAttribute

Remarques

Cette méthode appelle GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) avec des options définies sur None.

GetElementAtCore doit être implémenté dans une classe dérivée.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

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).

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 UIElement

Paramètres

index

Int32

int

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

options

ElementRealizationOptions

Valeur elementRealizationOptions qui 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.

Attributs

OverloadAttribute

Remarques

Cette méthode appelle GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) qui doit être implémenté dans une classe dérivée.

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 RecycleElement pour éviter les fuites de mémoire.

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