ItemsControl.DisplayMemberPath Propriété

Définition

Obtient ou définit le chemin d’une valeur de l’objet source qui sert de représentation visuelle de cet 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é

String

Chemin d’une valeur de l’objet source. Cela peut être n’importe quel chemin d’accès ou 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 respectivement aux System.ComponentModel espaces de noms et System.Windows.Data aux espaces de noms.

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 l’é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 la valeur spécifiée 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

Champ d’identificateur DisplayMemberPathProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à

Voir aussi