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.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
<itemsControl DisplayMemberPath="propertyPath"/>
XAML Values
Property Value
Type: System.StringThe 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
<Grid> <Grid.Resources> <src:Customers x:Key="customers"/> </Grid.Resources> <ListBox ItemsSource="{StaticResource customers}" Width="250" Margin="0,5,0,10" DisplayMemberPath="LastName" /> </Grid>
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")); } }