PropertyDescriptor.GetChildProperties Method (Object, Attribute())


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

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 Overridable Function GetChildProperties (
	instance As Object,
	filter As Attribute()
) As PropertyDescriptorCollection


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.

.NET Framework
Available since 1.1
Return to top