エクスポート (0) 印刷
すべて展開

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

ソース オブジェクトの値へのパス。これには、任意のパス、または "@Name" などの XPath を指定できます。既定値は空の文字列 ("") です。

識別子フィールド

DisplayMemberPathProperty

true に設定されたメタデータのプロパティ

なし

このプロパティは、データ オブジェクトの表示方法を説明する既定のテンプレートを定義する簡単な方法です。

次の例では、places という名前の静的リソースが、Place オブジェクトのコレクションとして定義されます。それぞれの Place オブジェクトは、CityName プロパティと State プロパティで構成されます。プレフィックス src は、データ ソース Places が定義されている名前空間にマップされます。プレフィックス scm および dat は、それぞれ System.ComponentModel 名前空間および System.Windows.Data 名前空間にマップされます。

次の例では、CityName で並べ替えられ、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>



次の例のように、ビューをバインディング ソースに指定できます。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

コミュニティの追加

追加
表示:
© 2014 Microsoft