ItemsControl.DisplayMemberPath Proprietà

Definizione

Spazio dei nomi:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Ottiene o imposta un percorso di un valore sull'oggetto di origine da usare come rappresentazione visiva dell'oggetto .

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

Valore della proprietà

String

Percorso di un valore nell'oggetto di origine. Può trattarsi di qualsiasi percorso o XPath, ad esempio "@Name". Il valore predefinito è una stringa vuota ("").

Attributi
BindableAttribute

Esempio

Nell'esempio seguente la risorsa statica denominata places è definita come una raccolta di Place oggetti, in cui ogni Place oggetto ha una CityName proprietà e una State proprietà. Il prefisso src viene mappato allo spazio dei nomi in cui è definita l'origine Places dati. I prefissi scm e dat vengono mappati rispettivamente agli spazi dei nomi System.ComponentModel e System.Windows.Data.

Nell'esempio seguente viene creata una visualizzazione della raccolta dati ordinata in base al nome della città e raggruppata in base allo stato.

<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 può essere un'origine di associazione, come nell'esempio seguente. A causa dell'oggetto specificato DisplayMemberPath, ogniPlace oggetto viene visualizzato con il relativo CityName valore. Se DisplayMemberPath non viene specificato e non DataTemplateè presente alcun oggetto , viene ListBox visualizzata una rappresentazione di stringa di ogni oggetto nell'insieme sottostante (in questo caso "SDKSample.Place").

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

Commenti

Questa proprietà è un modo semplice per definire un modello predefinito che descrive come visualizzare gli oggetti dati.

Informazioni sulle proprietà di dipendenza

Item Value
Campo Identificatore DisplayMemberPathProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a

Vedi anche