ITypedList.GetItemProperties Method (PropertyDescriptor[])

 

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
)

Parameters

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);
    }
    else
    {
        // Return properties in sort order.
        pdc = properties;
    }

    return pdc;
}

.NET Framework
Available since 1.1
Return to top
Show: