本文档已存档,并且将不进行维护。

ItemsControl.DisplayMemberPath 属性

更新:2007 年 11 月

获取或设置源对象上某个值的路径,该值作为对象的可视化表示形式。这是一个依赖项属性。

命名空间:  System.Windows.Controls
程序集:  PresentationFramework(在 PresentationFramework.dll 中)
用于 XAML 的 XMLNS:http://schemas.microsoft.com/winfx/xaml/presentation

[BindableAttribute(true)]
public string DisplayMemberPath { get; set; }
/** @property */
/** @attribute BindableAttribute(true) */
public String get_DisplayMemberPath()
/** @property */
/** @attribute BindableAttribute(true) */
public  void set_DisplayMemberPath(String value)

public function get DisplayMemberPath () : String
public function set DisplayMemberPath (value : String)
<object DisplayMemberPath="string" .../>

属性值

类型:System.String

源对象上的值的路径。这可以是任何路径,或 XPath(如“@Name”)。默认值为空字符串 ("")。

标识符字段

DisplayMemberPathProperty

设置为 true 的元数据属性

此属性是定义描述如何显示数据对象的默认模板的一种简便方式。

在下面的示例中,将名为 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>


有关完整示例,请参见在 XAML 中对数据进行排序和分组的示例

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

.NET Framework

受以下版本支持:3.5、3.0
显示: