ItemsControl.DisplayMemberPath Свойство

Определение

Получает или задает путь к значению исходного объекта, которое будет служить визуальным представлением объекта.

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

Значение свойства

String

Путь к значению исходного объекта. Это может быть любой путь или XPath, такие как "@Name". Значение по умолчанию — пустая строка ("").

Атрибуты

Примеры

В следующем примере статический ресурс определяется places как коллекция Place объектов, в которых каждый Place объект имеет CityName свойство и State свойство. Префикс src сопоставляется с пространством имен, в котором определен источник Places данных. Префиксы scm и dat сопоставляются с System.ComponentModel System.Windows.Data пространствами имен соответственно.

В следующем примере создается представление сбора данных, отсортированного по имени города и сгруппированного по состоянию.

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

Представление может быть источником привязки, как показано в следующем примере. Из-за указанного DisplayMemberPathзначения каждыйPlace объект отображается со своим CityName значением. Если DisplayMemberPath не указано и нет DataTemplate, ListBox отображается строковое представление каждого объекта в базовой коллекции (в данном случае —SDKSample.Place).

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

Комментарии

Это свойство является простым способом определения шаблона по умолчанию, описывающего отображение объектов данных.

Сведения о свойстве зависимостей

Поле идентификатора DisplayMemberPathProperty
Metadata properties set to true Нет

Применяется к

См. также раздел