This documentation is archived and is not being maintained.

PropertyDescriptor.GetChildProperties Method (Object, Attribute[])

Returns a PropertyDescriptorCollection for a given object using a specified array of attributes as a filter.

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

public virtual PropertyDescriptorCollection GetChildProperties(
	Object instance,
	Attribute[] filter


Type: System.Object

A component to get the properties for.

Type: System.Attribute[]

An array of type Attribute to use as a filter.

Return Value

Type: System.ComponentModel.PropertyDescriptorCollection
A PropertyDescriptorCollection with the properties that match the specified attributes for the specified component.

The properties for the instance parameter can differ from the properties of a class, because the site can add or remove properties if the instance parameter is sited.

The filter parameter can mix Type and Attribute objects. Filtering is defined by the following rules:

  • A Type object is treated as a wildcard; it matches any property that has the Type in its set of attributes.

  • If a property does not have an Attribute of the same class, the property will not be included in the returned array.

  • If the attribute is an instance of Attribute, the property must be an exact match to be included in the returned array.

  • If you specify an Attribute instance and it is the default property, it will be included in the returned array even if there is no instance of the Attribute in the property.

Generally, child properties should be returned by implementing the GetProperties member of the TypeConverter returned from this property.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0