DisplayMemberPath Property
Collapse the table of content
Expand the table of content

ItemsControl.DisplayMemberPath Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets or sets the name or path of the property that is displayed for each data item.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.

public string DisplayMemberPath { get; set; }
<itemsControl DisplayMemberPath="propertyPath"/>

XAML Values


A CLR property path.

Property Value

Type: System.String
The name or path of the property that is displayed for each the data item in the control. The default is an empty string ("").

Dependency property identifier field: DisplayMemberPathProperty

DisplayMemberPath can use a dotted path to reference subproperties of properties. For more information, see Data binding for Windows Phone 8.

The following example creates a ListBox, which inherits from ItemsControl, and binds it to a collection of Customer objects. The example sets the DisplayMemberPathProperty to the LastName property of the customer. Therefore, the ListBox displays the following values:

  • Anderberg

  • Ashton

  • Hicks

  • Pica

        <src:Customers x:Key="customers"/>
    <ListBox ItemsSource="{StaticResource customers}" Width="250" Margin="0,5,0,10" 
       DisplayMemberPath="LastName"  />

The following example shows the Customer class and the collection that the ListBox is bound to.

public class Customer
    public String FirstName { get; set; }
    public String LastName { get; set; }
    public String Address { get; set; }

    public Customer(String firstName, String lastName, String address)
        this.FirstName = firstName;
        this.LastName = lastName;
        this.Address = address;


public class Customers : ObservableCollection<Customer>
    public Customers()
        Add(new Customer("Michael", "Anderberg",
                "12 North Third Street, Apartment 45"));
        Add(new Customer("Chris", "Ashton",
                "34 West Fifth Street, Apartment 67"));
        Add(new Customer("Cassie", "Hicks",
                "56 East Seventh Street, Apartment 89"));
        Add(new Customer("Guido", "Pica",
                "78 South Ninth Street, Apartment 10"));


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2018 Microsoft