Langue

ItemsControl.DisplayMemberPath Propriété

Définition

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

public:
 property System::String ^ DisplayMemberPath { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string DisplayMemberPath { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.DisplayMemberPath : string with get, set
Public Property DisplayMemberPath As String

Valeur de propriété

Chemin d’accès à une valeur sur l’objet source. Il peut s’agir de n’importe quel chemin d’accès ou d’un XPath tel que « @Name ». La valeur par défaut est une chaîne vide ( » « ).

Attributs

Exemples

Dans l’exemple suivant, la ressource statique nommée places est définie comme une collection d’objets Place , dans laquelle chaque Place objet a une CityName propriété et une State propriété. Le préfixe src est mappé à l’espace de noms où la source Places de données 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 collection de données triée par le nom de la ville et regroupée par état.

<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 spécifié DisplayMemberPath, chaquePlace objet est affiché avec sa CityName valeur. S’il DisplayMemberPath n’est pas spécifié et qu’il n’y a pas DataTemplate, il ListBox affiche une représentation sous-jacente de chaque objet dans la collection sous-jacente (dans ce cas, « SDKSample.Place »).

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

Remarques

Cette propriété est un moyen simple de définir un modèle par défaut qui décrit comment afficher les objets de données.

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

Élément Valeur
Champ d’identificateur DisplayMemberPathProperty
Propriétés de métadonnées définies sur true None

S’applique à

Voir aussi