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

Definición

Obtiene o establece una ruta de acceso en un valor en el objeto de origen que actúa como representación visual del objeto.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

Valor de propiedad

La ruta de acceso a un valor en el objeto de origen.The path to a value on the source object. Esto puede ser cualquier ruta de acceso, o una expresión XPath como "@Name".This can be any path, or an XPath such as "@Name". El valor predeterminado es una cadena vacía ("").The default is an empty string ("").

Ejemplos

En el ejemplo siguiente, el recurso estático denominado places se define como una colección de Place objetos, donde cada Place objeto tiene un CityName propiedad y un State propiedad.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. El prefijo src se asigna al espacio de nombres donde el origen de datos Places está definido.The prefix src is mapped to the namespace where the data source Places is defined. Los prefijos scm y dat se asignan a la System.ComponentModel y System.Windows.Data espacios de nombres, respectivamente.The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

El ejemplo siguiente crea una vista de la recopilación de datos que se ordenan por el nombre de ciudad y agrupada por el estado.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>

La vista puede ser un origen de enlace, como en el ejemplo siguiente.The view can be a binding source, as in the following example. Debido a la especificada DisplayMemberPath, cadaPlace objeto se muestra con su CityName valor.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. Si DisplayMemberPath no se especifica y no hay ningún DataTemplate, el ListBox muestra una representación de cadena de cada objeto de la colección subyacente (en este caso, "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>

Comentarios

Esta propiedad es una manera sencilla de definir una plantilla predeterminada que se describe cómo mostrar los objetos de datos.This property is a simple way to define a default template that describes how to display the data objects.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field DisplayMemberPathProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a

Consulte también: