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, setPublic Property DisplayMemberPath As 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 |
Нет |
| Продукт | Версии |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |