ItemsControl.DisplayMemberPath Eigenschaft

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 ein beliebiger Pfad oder ein XPath sein, z@Name. b. "".This can be any path, or an XPath such as "@Name". Der Standardwert ist eine leere Zeichenfolge ("").The default is an empty string ("").

Attribute

Beispiele

Im folgenden Beispiel wird die statische Ressource mit dem places Namen als eine Auflistung von Place -Objekten definiert, wobei jedes Place -Objekt über CityName eine-Eigenschaft State und eine-Eigenschaft verfügt.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- src Präfix wird dem-Namespace zugeordnet, in Places dem die Datenquelle 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.

Im folgenden Beispiel wird eine Ansicht der Datensammlung erstellt, die nach dem Namen der Stadt sortiert und nach dem-Status gruppiert ist.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 eine Bindungs Quelle sein, wie im folgenden Beispiel gezeigt.The view can be a binding source, as in the following example. Aufgrund der angegebenen DisplayMemberPathwird jedesPlace Objekt mit seinem CityName Wert angezeigt.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. Wenn DisplayMemberPath nicht angegeben ist und kein DataTemplatevorhanden ist, zeigt das ListBox eine Zeichen folgen Darstellung jedes Objekts in der zugrunde liegenden Auflistung an (in diesem Fall "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>

Hinweise

Diese Eigenschaft ist eine einfache Möglichkeit, eine Standardvorlage zu definieren, die beschreibt, wie die Datenobjekte angezeigt werden.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

BezeichnerfeldIdentifier field DisplayMemberPathProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch