Cette documentation est archivée et n’est pas conservée.

ItemsControl.DisplayMemberPath, propriété

Mise à jour : novembre 2007

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

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

[BindableAttribute(true)]
public string DisplayMemberPath { get; set; }
/** @property */
/** @attribute BindableAttribute(true) */
public String get_DisplayMemberPath()
/** @property */
/** @attribute BindableAttribute(true) */
public  void set_DisplayMemberPath(String value)

public function get DisplayMemberPath () : String
public function set DisplayMemberPath (value : String)
<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 ("").

Champ d'identificateur

DisplayMemberPathProperty

Propriétés de métadonnées ayant la valeurtrue

Aucune

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.

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.

<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 du DisplayMemberPath spécifié, chaque objet Place 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").

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


Pour obtenir l'exemple complet, consultez Tri et regroupement de données en XAML, exemple.

Windows Vista

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

.NET Framework

Pris en charge dans : 3.5, 3.0
Afficher: