ItemsControl.DisplayMemberPath Propriedade

Definição

Obtém ou define um caminho para um valor no objeto de origem para servir como a representação visual do objeto.

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

Valor da propriedade

String

O caminho para um valor no objeto de origem. Esse pode ser qualquer caminho ou um XPath como "@Name". O padrão é uma cadeia de caracteres vazia ("").

Atributos

Exemplos

No exemplo a seguir, o recurso estático nomeado places é definido como uma coleção de Place objetos, em que cada Place objeto tem uma CityName propriedade e uma State propriedade. O prefixo src é mapeado para o namespace em que a fonte de Places dados é definida. Os prefixos scm e dat são mapeados para os namespaces e System.Windows.Data os System.ComponentModel namespaces, respectivamente.

O exemplo a seguir cria uma exibição da coleta de dados classificada por nome de cidade e agrupada por estado.

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

O modo de exibição pode ser uma fonte de associação, como no exemplo a seguir. Devido ao especificado DisplayMemberPath, cadaPlace objeto é mostrado com seu CityName valor. Se DisplayMemberPath não for especificado e não DataTemplatehouver, será ListBox exibida uma representação de cadeia de caracteres de cada objeto na coleção subjacente (nesse caso, "SDKSample.Place").

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

Comentários

Essa propriedade é uma maneira simples de definir um modelo padrão que descreve como exibir os objetos de dados.

Informações da propriedade de dependência

Campo Identificador DisplayMemberPathProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também