ItemsControl.DisplayMemberPath Właściwość

Definicja

Pobiera lub ustawia ścieżkę do wartości w obiekcie źródłowym, aby służyć jako wizualna reprezentacja obiektu.

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

Wartość właściwości

String

Ścieżka do wartości w obiekcie źródłowym. Może to być dowolna ścieżka lub ścieżka XPath, taka jak "@Name". Wartością domyślną jest ciąg pusty ("").

Atrybuty

Przykłady

W poniższym przykładzie zasób statyczny o nazwie places jest zdefiniowany jako kolekcja Place obiektów, w której każdy Place obiekt ma CityName właściwość i State właściwość. Prefiks src jest mapowany na przestrzeń nazw, w której zdefiniowano źródło Places danych. Prefiksy scm i dat są mapowane odpowiednio na System.ComponentModel przestrzenie nazw i System.Windows.Data .

Poniższy przykład tworzy widok zbierania danych posortowany według nazwy miasta i pogrupowany według stanu.

<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>

Widok może być źródłem powiązania, jak w poniższym przykładzie. Ze względu na określony DisplayMemberPathobiekt jestPlace wyświetlany z jego CityName wartością. Jeśli DisplayMemberPath nie określono parametru i nie DataTemplatema wartości , ListBox program wyświetla reprezentację ciągu każdego obiektu w kolekcji bazowej (w tym przypadku "SDKSample.Place").

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

Uwagi

Ta właściwość to prosty sposób definiowania szablonu domyślnego opisującego sposób wyświetlania obiektów danych.

Informacje dotyczące właściwości zależności

Pole identyfikatora DisplayMemberPathProperty
Właściwości metadanych ustawione na true Brak

Dotyczy

Zobacz też