ItemsControl.DisplayMemberPath Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 |