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; }
[<System.ComponentModel.Bindable(true)>]
member this.DisplayMemberPath : string with get, set
Public Property DisplayMemberPath As String

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

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 объектов, в которой Place у каждого объекта есть CityName свойство и 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

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

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