ItemsControl.DisplayMemberPath Eigenschaft

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Dient zum Abrufen oder Festlegen eines Pfads zu einem Wert für das Quellobjekt, das als visuelle Darstellung des Objekts dient.

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 benannte places statische Ressource als Eine Auflistung von Place Objekten definiert, in der jedes Place Objekt über eine CityName Eigenschaft und eine 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 werden den Namespaces System.ComponentModel und System.Windows.Data namespaces zugeordnet.

Im folgenden Beispiel wird eine Ansicht der Datensammlung erstellt, die nach dem Ortsnamen sortiert und nach dem Bundesland 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 gezeigt. Aufgrund des angegebenen DisplayMemberPathWerts wird jedesPlace Objekt mit seinem CityName Wert angezeigt. Wenn DisplayMemberPath nicht angegeben und kein DataTemplateWert vorhanden ist, zeigt die ListBox Zeichenfolgendarstellung jedes Objekts in der zugrunde liegenden Auflistung an (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 zum Definieren einer Standardvorlage, die beschreibt, wie die Datenobjekte angezeigt werden.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld DisplayMemberPathProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für:

Weitere Informationen