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

Definition

Ruft einen Pfad zu einem Wert im Quellobjekt ab, das für die visuelle Darstellung des Objekts verwendet wird, oder legt diesen Pfad fest.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

Eigenschaftswert

Der Pfad zu einem Wert im Quellobjekt.The path to a value on the source object. Dies kann einen beliebigen Pfad oder ein XPath-Ausdruck wie z. B. sein "@Name".This can be any path, or an XPath such as "@Name". Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Beispiele

Im folgenden Beispiel die statische Ressource namens places ist definiert als eine Auflistung von Place -Objekte, in denen die einzelnen Place Objekt verfügt über eine CityName Eigenschaft und eine State Eigenschaft.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. Das Präfix src zugeordnet ist, auf den Namespace, in dem die Datenquelle Places definiert ist.The prefix src is mapped to the namespace where the data source Places is defined. Die Präfixe scm und dat zugeordnet sind die System.ComponentModel und System.Windows.Data Namespaces bzw.The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

Das folgende Beispiel erstellt einen Überblick über die Datensammlung, die durch den Namen der Stadt sortiert und gruppiert nach den Status an.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>

Die Sicht kann es sich um eine Bindungsquelle, wie im folgenden Beispiel sein.The view can be a binding source, as in the following example. Aufgrund der angegebenen DisplayMemberPath, die jeweilsPlace Objekt wird angezeigt, mit dessen CityName Wert.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. Wenn DisplayMemberPath nicht angegeben ist und es gibt keine DataTemplate, und klicken Sie dann die ListBox eine Zeichenfolgendarstellung der einzelnen Objekte in der zugrunde liegenden Auflistung (in diesem Fall "SDKSample.Place") angezeigt.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>

Hinweise

Diese Eigenschaft ist eine einfache Möglichkeit zum Definieren einer Standardvorlage, die beschreibt, wie Sie die Datenobjekte angezeigt.This property is a simple way to define a default template that describes how to display the data objects.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field DisplayMemberPathProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für:

Siehe auch