VirtualizingLayoutContext.GetOrCreateElementAt Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Surcharges

GetOrCreateElementAt(Int32)	Récupère un élément 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éé.
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Récupère un élément 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.

GetOrCreateElementAt(Int32)

Récupère un élément 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éé.

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

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 les options définies sur None.

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

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Récupère un élément 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.

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

Paramètres

index

Int32

int

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

options

ElementRealizationOptions

Valeur de 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 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.