要查看英语原文,请勾选“英语”复选框。也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语
本文档已存档,并且将不进行维护。

ItemsControl.DisplayMemberPath 属性

获取或设置源对象上某个值的路径,该值作为对象的可视化表示形式。

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

[BindableAttribute(true)]
public string DisplayMemberPath { get; set; }
<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>


.NET Framework

受以下版本支持:4、3.5、3.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2

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