ItemsControl.DisplayMemberPath Proprietà

Definizione

Ottiene o imposta un percorso su un valore nell'oggetto di origine per fornire la 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à

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

Attributi

Esempio

Nell'esempio seguente la risorsa statica denominata places è definita come 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 System.ComponentModel spazi dei nomi 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 è specificato e non DataTemplateè presente , visualizza ListBox 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 proprietà di dipendenza

Campo Identificatore DisplayMemberPathProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a

Vedi anche