ItemsControl.DisplayMemberPath ItemsControl.DisplayMemberPath ItemsControl.DisplayMemberPath ItemsControl.DisplayMemberPath Property

定義

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

public:
 property System::String ^ DisplayMemberPath { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
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. これは、任意パス、または XPath など"@Name"。This can be any path, or an XPath such as "@Name". 既定値は、空の文字列 ("") です。The default is an empty string ("").

静的リソースでは、次の例では、名前placesのコレクションとして定義されますPlaceオブジェクトは、各Placeオブジェクトが、CityNameプロパティとStateプロパティ。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.

<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>

ビューには、次の例のように、バインディング ソースを指定できます。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が指定されていないがないDataTemplateListBox (この例では、"SDKSample.Place") では、基になるコレクション内の各オブジェクトの文字列表現を表示します。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">
  <ListBox.GroupStyle>
    <x:Static Member="GroupStyle.Default"/>
  </ListBox.GroupStyle>
</ListBox>

注釈

このプロパティは、データ オブジェクトを表示する方法について説明する既定のテンプレートを定義する単純な方法です。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 なしNone

適用対象

こちらもご覧ください