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
Значение свойства
Путь к значению исходного объекта. Это может быть любой путь или 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 |
Нет |