ITypedList.GetItemProperties Method (PropertyDescriptor[])


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Returns the PropertyDescriptorCollection that represents the properties on each item used to bind data.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)

PropertyDescriptorCollection GetItemProperties(
	PropertyDescriptor[] listAccessors


Type: System.ComponentModel.PropertyDescriptor[]

An array of PropertyDescriptor objects to find in the collection as bindable. This can be null.

Return Value

Type: System.ComponentModel.PropertyDescriptorCollection

The PropertyDescriptorCollection that represents the properties on each item used to bind data.

If the listAccessors parameter is not null, it typically contains a property descriptor that identifies a list of containers to retrieve for the object that implements ITypedList. For example, a DataSet containing two tables, myCustomers and myOrders, with a relationship between them called myCustOrders. If you create a DataView object to view myCustomers, then calling the GetItemProperties method with null returns the property descriptors for the columns in myCustomers. As a result, one of the returned property descriptors is a property descriptor for myCustOrders, just as calling the GetItemProperties method with a list accessor array containing the property descriptors for myCustOrders will return the property descriptors for myOrders.

The following code example demonstrates how to implement the GetItemProperties method. For a full code listing, see How to: Implement the ITypedList Interface.

public PropertyDescriptorCollection GetItemProperties(PropertyDescriptor[] listAccessors)
    PropertyDescriptorCollection pdc;

    if (listAccessors!=null && listAccessors.Length>0)
        // Return child list shape.
        pdc = ListBindingHelper.GetListItemProperties(listAccessors[0].PropertyType);
        // Return properties in sort order.
        pdc = properties;

    return pdc;

.NET Framework
Available since 1.1
Return to top