DataTemplate.GetElement(ElementFactoryGetArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée ou récupère un instance existant de l’objet UIElement déclaré dans le DataTemplate.
UIElement GetElement(ElementFactoryGetArgs const& args);
public UIElement GetElement(ElementFactoryGetArgs args);
function getElement(args)
Public Function GetElement (args As ElementFactoryGetArgs) As UIElement
Paramètres
Instance d’ElementFactoryGetArgs.
Retours
Une instance de l’élément UIElement racine déclaré dans le DataTemplate ou null si la racine du DataTemplate n’est pas un UIElement.
Implémente
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 1809 (introduit dans 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v7.0)
|
Remarques
Le DataTemplate agit comme une fabrique qui génère l’objet d’élément déclaré dans son modèle. Contrairement à la méthode LoadContent qui crée une instance chaque fois qu’elle est appelée, la méthode GetElement peut créer un instance ou renvoyer une instance existante qui a été recyclée via RecycleElement.
L’implémentation de GetElement par DataTemplate n’utilise pas la valeur Data de l’élément ElementFactoryGetArgs. La propriété Data existe pour les implémentations telles que DataTemplateSelector , où elle est utilisée pour décider à partir de laquelle DataTemplate charger du contenu.