Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
DataTemplate, classe
Collapse the table of content
Expand the table of content
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DataTemplate, classe

Décrit la structure visuelle d'un objet de données.

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[DictionaryKeyPropertyAttribute("DataTemplateKey")]
public class DataTemplate : FrameworkTemplate
<DataTemplate>
  VisualTree
</DataTemplate>

Le type DataTemplate expose les membres suivants.

  NomDescription
Méthode publiqueDataTemplate()Initialise une nouvelle instance de la classe DataTemplate.
Méthode publiqueDataTemplate(Object)Initialise une nouvelle instance de la classe DataTemplate avec la propriété DataType spécifiée.
Début

  NomDescription
Propriété publiqueDataTemplateKeyObtient la clé par défaut de DataTemplate.
Propriété publiqueDataTypeObtient ou définit le type auquel ce DataTemplate est destiné.
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueDispatcher (Hérité de DependencyObject.)
Propriété publiqueHasContentObtient une valeur qui indique si ce modèle a optimisé le contenu. (Hérité de FrameworkTemplate.)
Propriété publiqueIsSealedObtient une valeur qui indique si cet objet est dans un état immuable (c'est-à-dire qu'il ne peut pas être modifié). (Hérité de FrameworkTemplate.)
Propriété publiqueResourcesObtient ou définit la collection des ressources qui peuvent être utilisées dans la portée de ce modèle. (Hérité de FrameworkTemplate.)
Propriété publiqueTemplateObtient ou définit une référence à l'objet qui enregistre ou lit les nœuds XAML pour le modèle lorsque le modèle est défini ou appliqué par un writer. (Hérité de FrameworkTemplate.)
Propriété publiqueTriggersObtient une collection de déclencheurs qui appliquent des valeurs de propriétés ou effectuent des actions selon une ou plusieurs conditions.
Propriété publiqueVisualTreeObtient ou définit le nœud racine du modèle. (Hérité de FrameworkTemplate.)
Début

  NomDescription
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindNameRecherche l'élément associé au nom spécifié défini dans ce modèle. (Hérité de FrameworkTemplate.)
Méthode publiqueGetAnimationBaseValue (Hérité de DependencyObject.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueLoadContentCharge le contenu du modèle en tant qu'instance d'un objet et retourne l'élément racine du contenu. (Hérité de FrameworkTemplate.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode publiqueRegisterNameInscrit une nouvelle paire nom-objet dans la portée de nom active. (Hérité de FrameworkTemplate.)
Méthode publiqueSealVerrouille le modèle de façon à ce qu'il ne puisse pas être modifié. (Hérité de FrameworkTemplate.)
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publiqueShouldSerializeResourcesRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété Resources sur les instances de cette classe. (Hérité de FrameworkTemplate.)
Méthode publiqueShouldSerializeVisualTreeRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété VisualTree sur les instances de cette classe. (Hérité de FrameworkTemplate.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueUnregisterNameSupprime un mappage nom/objet de la portée de nom XAML. (Hérité de FrameworkTemplate.)
Méthode protégéeValidateTemplatedParentVérifie le parent basé sur des modèles par rapport à un ensemble de règles. (Substitue FrameworkTemplate.ValidateTemplatedParent(FrameworkElement).)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeINameScope.FindNameInfrastructure. Retourne un objet qui porte le nom d'identification fourni. (Hérité de FrameworkTemplate.)
Implémentation d'interface expliciteMéthode privéeIQueryAmbient.IsAmbientPropertyAvailableDemande si une propriété ambiante spécifiée est disponible dans la portée actuelle. (Hérité de FrameworkTemplate.)
Début

Utilisez un DataTemplate pour spécifier la visualisation de vos objets de données. Les objets DataTemplate sont particulièrement utiles lorsque vous liez un ItemsControl tel qu'un ListBox à une collection entière. Sans instruction particulière, ListBox affiche la représentation sous forme de chaîne des objets d'une collection. Dans ce cas, vous pouvez utiliser DataTemplate pour définir l'apparence de vos objets de données. Le contenu de DataTemplate devient la structure visuelle de vos objets de données.

Pour une discussion détaillée, consultez Vue d'ensemble des modèles de données.

L'exemple de code suivant illustre comment créer un objet DataTemplate inline. DataTemplate spécifie que chaque élément de données apparaît sous forme de trois éléments TextBlock dans un objet StackPanel. Dans cet exemple, l'objet de donnée correspond à une classe appelée Task. Notez que chaque élément TextBlock de ce modèle est lié à une propriété de la classe Task.


<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}">
   <ListBox.ItemTemplate>
     <DataTemplate>
       <StackPanel>
         <TextBlock Text="{Binding Path=TaskName}" />
         <TextBlock Text="{Binding Path=Description}"/>
         <TextBlock Text="{Binding Path=Priority}"/>
       </StackPanel>
     </DataTemplate>
   </ListBox.ItemTemplate>
 </ListBox>


Il est plus courant de définir DataTemplate dans la section des ressources afin d'en faire un objet réutilisable, comme dans l'exemple suivant :


<Window.Resources>


...


<DataTemplate x:Key="myTaskTemplate">
  <StackPanel>
    <TextBlock Text="{Binding Path=TaskName}" />
    <TextBlock Text="{Binding Path=Description}"/>
    <TextBlock Text="{Binding Path=Priority}"/>
  </StackPanel>
</DataTemplate>


...


</Window.Resources>


Vous pouvez à présent utiliser myTaskTemplate en tant que ressource, comme dans l'exemple suivant :


<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}"
         ItemTemplate="{StaticResource myTaskTemplate}"/>


Pour obtenir l'exemple complet, consultez la rubrique Introduction aux modèles de données, exemple.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft