ItemsControl.DisplayMemberPath プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトの視覚的表現として機能するソース オブジェクトの値へのパスを取得または設定します。
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
プロパティ値
ソース オブジェクトの値へのパス。 任意のパス、または "@Name" などの XPath を指定できます。 既定値は空の文字列 ("") です。
- 属性
例
次の例では、 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 |
に設定されたメタデータ プロパティ true |
None |