Changer de bibliothèque

MSDN Library

Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

ItemsControl.DisplayMemberPath, propriété

.NET Framework 4

Autres versions

Obtient ou définit un chemin d'accès à une valeur de l'objet source à servir comme représentation visuelle de l'objet.

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

Syntaxe

C++

[BindableAttribute(true)]
public string DisplayMemberPath { get; set; }

Utilisation des attributs XAML

<object DisplayMemberPath="string" .../>

Valeur de propriété

Type : System.String
Chemin d'accès à une valeur de l'objet source. Il peut s'agir de n'importe quel chemin d'accès, ou un XPath tel que "@Nom". La valeur par défaut est une chaîne vide ("").

Informations sur les propriétés de dépendance

Champ d'identificateur	DisplayMemberPathProperty
Propriétés de métadonnées définies à true	Aucun

Notes

Cette propriété est une façon simple de définir un modèle par défaut décrivant la manière d'afficher les objets de données.

Exemples

Dans l'exemple suivant, la ressource statique nommée places est définie comme une collection d'objets Place dans laquelle chaque objet Place a une propriété CityName et une propriété State. Le préfixe src est mappé à l'espace de noms où la source de données Places est définie. Les préfixes scm et dat sont mappés aux espaces de noms System.ComponentModel et System.Windows.Data, respectivement.

L'exemple suivant crée une vue de la collecte de données triée par nom de ville et groupée par état.

XAML


  <Window.Resources>

    <src:Places x:Key="places"/>

    <CollectionViewSource Source="{StaticResource places}" x:Key="cvs">
      <CollectionViewSource.SortDescriptions>
        <scm:SortDescription PropertyName="CityName"/>
      </CollectionViewSource.SortDescriptions>
      <CollectionViewSource.GroupDescriptions>
        <dat:PropertyGroupDescription PropertyName="State"/>
      </CollectionViewSource.GroupDescriptions>
    </CollectionViewSource>

La vue peut être une source de liaison, comme dans l'exemple suivant. En raison de l'objet DisplayMemberPath spécifié, chaque objetPlace est affiché avec sa valeur CityName. Si DisplayMemberPath n'est pas spécifiée et s'il n'y a pas de DataTemplate, la ListBox affiche une représentation sous forme de chaîne de chaque objet dans la collection sous-jacente (dans le cas présent, "SDKSample.Place").

XAML


<ListBox ItemsSource="{Binding Source={StaticResource cvs}}"
         DisplayMemberPath="CityName" Name="lb">
  <ListBox.GroupStyle>
    <x:Static Member="GroupStyle.Default"/>
  </ListBox.GroupStyle>
</ListBox>

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.

Voir aussi