ItemsControl.DisplayMemberPath 속성

정의

개체의 시각적 표시로 사용할 소스 개체의 값에 대한 경로를 가져오거나 설정합니다.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; }
member this.DisplayMemberPath : string with get, set
Public Property DisplayMemberPath As String

속성 값

String

소스 개체의 값에 대한 경로입니다.The path to a value on the source object. 이는 임의의 경로 이거나 "@Name"와 같은 XPath 일 수 있습니다.This can be any path, or an XPath such as "@Name". 기본값은 빈 문자열("")입니다.The default is an empty string ("").

특성

예제

다음 예제에서 places 이라는 정적 리소스는 각 Place 개체에 CityName 속성과 State 속성이 있는 Place 개체의 컬렉션으로 정의 됩니다.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. src 접두사는 데이터 원본이 Places 정의 되는 네임 스페이스에 매핑됩니다.The prefix src is mapped to the namespace where the data source Places is defined. scmdat 접두사는 각각 System.ComponentModelSystem.Windows.Data 네임 스페이스로 매핑됩니다.The prefixes scm and dat are mapped to the System.ComponentModel and System.Windows.Data namespaces, respectively.

다음 예제에서는 도시 이름별으로 정렬 되 고 상태별으로 그룹화 된 데이터 컬렉션의 뷰를 만듭니다.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>

뷰는 다음 예제와 같이 바인딩 소스를 수 있습니다.The view can be a binding source, as in the following example. 지정 된 DisplayMemberPath때문에 각Place 개체에 CityName 값이 표시 됩니다.Because of the specified DisplayMemberPath, eachPlace object is shown with its CityName value. DisplayMemberPath 지정 되지 않은 경우 DataTemplate없는 경우 ListBox는 기본 컬렉션 (이 경우 "SDKSample")의 각 개체에 대 한 문자열 표현을 표시 합니다.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>

설명

이 속성은 데이터 개체를 표시 하는 방법에 설명 하는 기본 템플릿을 정의 하는 간단한 방법입니다.This property is a simple way to define a default template that describes how to display the data objects.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field DisplayMemberPathProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보