ItemsControl.DisplayMemberPath Свойство

Определение

Возвращает или задает путь к значению в объекте источника в качестве визуального представления объекта.Gets or sets a path to a value on the source object to serve as the visual representation of the object.

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

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

Путь к значению объекта источника.The path to a value on the source object. Это может быть любой путь или XPath, такие как "@Name".This can be any path, or an XPath such as "@Name". Значение по умолчанию — пустая строка ("").The default is an empty string ("").

Атрибуты

Примеры

В следующем примере places статический ресурс с именем определяется как Place коллекция объектов, в CityName которой у каждого Place объекта есть свойство и State свойство.In the following example, the static resource named places is defined as a collection of Place objects, in which each Place object has a CityName property and a State property. Префикс src сопоставляется с пространством имен, в котором определен Places источник данных.The prefix src is mapped to the namespace where the data source Places is defined. Префиксы scm и dat сопоставляются с System.ComponentModel пространствами имен System.Windows.Data и соответственно.The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

В следующем примере создается представление коллекции данных, которая сортируется по названию города и группируются по состоянию.The following example creates a view of the data collection that is sorted by the city name and grouped by the state.

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

Представление может быть источником привязки, как показано в следующем примере.The view can be a binding source, as in the following example. Из-за указанного DisplayMemberPathзначения каждыйPlace объект отображается со своим CityName значением.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. Если DisplayMemberPath параметр не указан и нет DataTemplate, то ListBox отображает строковое представление каждого объекта в базовой коллекции (в данном случае "сдксампле. Place").If DisplayMemberPath is not specified and there is no DataTemplate, then the ListBox displays a string representation of each object in the underlying collection (in this case, "SDKSample.Place").

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

Комментарии

Это свойство является простым способом определения шаблона по умолчанию, который описывает способ отображения объектов данных.This property is a simple way to define a default template that describes how to display the data objects.

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

Поле идентификатораIdentifier field DisplayMemberPathProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

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

Дополнительно