本文件已封存並已停止維護。

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
顯示: