ItemsControl.DisplayMemberPath Özellik

Tanım

Nesnenin görsel temsili olarak kullanılacak kaynak nesnede bir değerin yolunu alır veya ayarlar.Gets or sets a path to a value on the source object to serve as the visual representation of the object.

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

Özellik Değeri

String

Kaynak nesnedeki bir değerin yolu.The path to a value on the source object. Bu, herhangi bir yol veya "" gibi bir XPath olabilir @Name .This can be any path, or an XPath such as "@Name". Varsayılan değer, boş dizedir ("").The default is an empty string ("").

Öznitelikler

Örnekler

Aşağıdaki örnekte, adlı statik kaynak, places Place her Place nesnenin bir CityName özelliği ve bir özelliği olduğu bir nesne koleksiyonu olarak tanımlanmıştır State .In the following example, the static resource named places is defined as a collection of Place objects, in which each Place object has a CityName property and a State property. Ön ek, src veri kaynağının tanımlandığı ad alanı ile eşleştirilir Places .The prefix src is mapped to the namespace where the data source Places is defined. Ön ekler scm ve dat System.ComponentModel System.Windows.Data sırasıyla ve ad alanları ile eşleştirilir.The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

Aşağıdaki örnek, şehir adına göre sıralanmış ve duruma göre gruplandırılan veri koleksiyonunun bir görünümünü oluşturur.The following example creates a view of the data collection that is sorted by the city name and grouped by the state.

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

Görünüm, aşağıdaki örnekte olduğu gibi bir bağlama kaynağı olabilir.The view can be a binding source, as in the following example. Belirtilen nedenle DisplayMemberPath , her Place nesne CityName değeriyle gösterilir.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. DisplayMemberPathBelirtilmemişse ve Hayır ise, DataTemplate ListBox temel koleksiyondaki her nesnenin dize gösterimini görüntüler (Bu durumda, "SDKSample. Place").If DisplayMemberPath is not specified and there is no DataTemplate, then the ListBox displays a string representation of each object in the underlying collection (in this case, "SDKSample.Place").

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

Açıklamalar

Bu özellik, veri nesnelerinin nasıl görüntüleneceğini açıklayan bir varsayılan şablon tanımlamanın basit bir yoludur.This property is a simple way to define a default template that describes how to display the data objects.

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanıIdentifier field DisplayMemberPathProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true YokNone

Şunlara uygulanır

Ayrıca bkz.