ItemsControl.DisplayMemberPath プロパティ


オブジェクトの視覚的表現として機能する、ソース オブジェクトの値へのパスを取得または設定します。Gets or sets a path to a value on the source object to serve as the visual representation of the object.

 property System::String ^ DisplayMemberPath { System::String ^ get(); void set(System::String ^ value); };
public string DisplayMemberPath { get; set; }
member this.DisplayMemberPath : string with get, set
Public Property DisplayMemberPath As String


ソース オブジェクトの値へのパス。The path to a value on the source object. 任意のパス、または "@Name" などの XPath を指定できます。This can be any path, or an XPath such as "@Name". 既定値は、空の文字列 ("") です。The default is an empty string ("").


次の例では、という名前placesの静的リソースがオブジェクトのPlaceコレクションとして定義Placeされています。 State各オブジェクトには、 CityNameプロパティとプロパティがあります。In the following example, the static resource named places is defined as a collection of Place objects, in which each Place object has a CityName property and a State property. プレフィックスsrcは、データソースPlacesが定義されている名前空間にマップされます。The prefix src is mapped to the namespace where the data source Places is defined. プレフィックスscmdatは、それぞれSystem.ComponentModelSystem.Windows.Dataの名前空間にマップされます。The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

次の例では、市区町村名で並べ替えられたデータコレクションのビューを作成し、州別にグループ化します。The following example creates a view of the data collection that is sorted by the city name and grouped by the state.


  <src:Places x:Key="places"/>

  <CollectionViewSource Source="{StaticResource places}" x:Key="cvs">
      <scm:SortDescription PropertyName="CityName"/>
      <dat:PropertyGroupDescription PropertyName="State"/>

ビューは、次の例のように、バインドソースにすることができます。The view can be a binding source, as in the following example. が指定さDisplayMemberPathれているPlaceため、各CityNameオブジェクトの値が表示されます。Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. DisplayMemberPath指定されておらず、 DataTemplateがない場合ListBox 、は、基になるコレクション (この場合は "SDKSample") 内の各オブジェクトの文字列形式を表示します。If DisplayMemberPath is not specified and there is no DataTemplate, then the ListBox displays a string representation of each object in the underlying collection (in this case, "SDKSample.Place").

<ListBox ItemsSource="{Binding Source={StaticResource cvs}}"
         DisplayMemberPath="CityName" Name="lb">
    <x:Static Member="GroupStyle.Default"/>


このプロパティは、データオブジェクトを表示する方法を説明する既定のテンプレートを定義する単純な方法です。This property is a simple way to define a default template that describes how to display the data objects.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field DisplayMemberPathProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone