ItemsControl.DisplayMemberPath Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft den Pfad zu einem Wert für das Quellobjekt ab, der als optische Darstellung des Objekts dienen soll, oder legt diesen fest.

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

Eigenschaftswert

String

Der Pfad zu einem Wert für das Quellobjekt. Dies kann ein beliebiger Pfad oder ein XPath wie "@Name" sein. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

BindableAttribute

Beispiele

Im folgenden Beispiel wird die statische Ressource als places Auflistung von Place Objekten definiert, in denen jedes Place Objekt über eine Eigenschaft und eine CityName State Eigenschaft verfügt. Das Präfix src wird dem Namespace zugeordnet, in dem die Datenquelle Places definiert ist. Die Präfixe scm und dat zugeordnet sind die System.ComponentModel und System.Windows.Data Namespaces bzw.

Im folgenden Beispiel wird eine Ansicht der Datensammlung erstellt, die nach dem Namen der Stadt sortiert und vom Zustand gruppiert wird.

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

Die Ansicht kann eine Bindungsquelle sein, wie im folgenden Beispiel. Aufgrund des angegebenen DisplayMemberPathObjekts wird jedesPlace Objekt mit seinem CityName Wert angezeigt. Wenn DisplayMemberPath nicht angegeben und es DataTemplatekeine gibt, wird die ListBox Zeichenfolgendarstellung jedes Objekts in der zugrunde liegenden Auflistung angezeigt (in diesem Fall "SDKSample.Place").

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

Hinweise

Diese Eigenschaft ist eine einfache Möglichkeit, eine Standardvorlage zu definieren, die beschreibt, wie die Datenobjekte angezeigt werden.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	DisplayMemberPathProperty
Metadateneigenschaften auf true festgelegt	Keine

Siehe auch

• ItemTemplate