ItemsControl.DisplayMemberPath Propriedade

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Obtém ou define um caminho para um valor no objeto de origem para servir como 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 de Propriedade

String

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

Atributos
BindableAttribute

Exemplos

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

O exemplo seguinte cria uma vista da recolha de dados ordenada pelo nome da cidade e agrupada pelo 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>

A vista pode ser uma fonte de ligação, como no exemplo seguinte. Devido ao especificado DisplayMemberPath, cadaPlace objeto é mostrado com o seu CityName valor. Se DisplayMemberPath não for especificado e não DataTemplatehouver , então apresenta ListBox uma representação de cadeia de cada objeto na coleção subjacente (neste caso, "SDKSample.Place").

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

Observações

Esta propriedade é uma forma simples de definir um template padrão que descreve como mostrar os objetos de dados.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador DisplayMemberPathProperty
Propriedades dos metadados definidas como true None

Aplica-se a

Ver também