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 的命名空间。 前缀scmdat分别映射到System.ComponentModelSystem.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
元数据属性设置为 true

适用于

另请参阅