DataTemplateSelector Classe

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Active la logique de sélection de modèle personnalisée au niveau de l’application.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTemplateSelector : IElementFactory

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DataTemplateSelector : IElementFactory

Public Class DataTemplateSelector
Implements IElementFactory

See Remarks

Héritage

Object IInspectable DataTemplateSelector

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IElementFactory

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Pour plus d’informations sur les modèles de données, consultez la classe DataTemplate et les conteneurs et modèles Item.

La classe DataTemplateSelector de base n’est pas utilisée comme élément objet en XAML. Toutefois, il est courant de dériver un DataTemplateSelector personnalisé, de mapper un xmlns préfixe pour la classe personnalisée et son espace de noms/assembly, puis de faire référence à un instance de la classe personnalisée telle que définie dans un bloc Resources en XAML. Cela permet de faire référence à la classe de sélecteur de modèle personnalisé par x:Key, et d’utiliser cette référence pour définir la valeur des propriétés telles que ItemTemplateSelector dans les modèles XAML et les états visuels.

Les méthodes callables de DataTemplateSelector sont les deux surcharges SelectTemplate . Les méthodes substituables de DataTemplateSelector sont les deux surcharges SelectTemplateCore . Pour définir une sous-classe DataTemplateSelector efficace, fournissez des implémentations pour SelectTemplateCore(Object) et SelectTemplateCore(Object, DependencyObject). Toutes ces méthodes retournent une instance DataTemplate qui est généralement un choix spécifique approprié pour les entrées de la méthode appelée pour l’obtenir.

Le code d’application n’appelle généralement pas les méthodes SelectTemplate ; les méthodes existent afin que l’infrastructure puisse l’appeler tout en choisissant les modèles appropriés en fonction de l’utilisation d’un DataTemplateSelector instance à partir d’une valeur de propriété telle que ItemsControl.ItemsTemplateSelector.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1809	17763	GetElement
1809	17763	RecycleElement

Constructeurs

DataTemplateSelector()

Initialise une nouvelle instance de la classe DataTemplateSelector.

Méthodes

GetElement(ElementFactoryGetArgs)	Crée ou récupère une instance existante de l’objet UIElement déclaré dans le DataTemplate retourné par SelectTemplate.
RecycleElement(ElementFactoryRecycleArgs)	Recycle un objet UIElement créé à l’aide de GetElement.
SelectTemplate(Object)	Retourne un DataTemplate spécifique pour un élément donné.
SelectTemplate(Object, DependencyObject)	Retourne un DataTemplate spécifique pour un élément et un conteneur donnés.
SelectTemplateCore(Object)	En cas d’implémentation par une classe dérivée, retourne un DataTemplate spécifique pour un élément ou conteneur donné.
SelectTemplateCore(Object, DependencyObject)	En cas d’implémentation par une classe dérivée, retourne un DataTemplate spécifique pour un élément ou conteneur donné.

Voir aussi

• ItemTemplateSelector
• DataTemplate
• ContentTemplateSelector
• HeaderTemplateSelector