TypeConverter.GetProperties Method (ITypeDescriptorContext, Object, Attribute[]) (System.ComponentModel)

GetProperties Method (ITypeDescriptorContext, O...

.NET Framework Class Library

TypeConverter..::.GetProperties Method (ITypeDescriptorContext, Object, array<Attribute>[]()[])

Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.

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

Syntax

Visual Basic (Declaration)

Public Overridable Function GetProperties ( _
    context As ITypeDescriptorContext, _
    value As Object, _
    attributes As Attribute() _
) As PropertyDescriptorCollection

Visual Basic (Usage)

Dim instance As TypeConverter
Dim context As ITypeDescriptorContext
Dim value As Object
Dim attributes As Attribute()
Dim returnValue As PropertyDescriptorCollection

returnValue = instance.GetProperties(context, _
    value, attributes)

public virtual PropertyDescriptorCollection GetProperties(
    ITypeDescriptorContext context,
    Object value,
    Attribute[] attributes
)

Visual C++

public:
virtual PropertyDescriptorCollection^ GetProperties(
    ITypeDescriptorContext^ context, 
    Object^ value, 
    array<Attribute^>^ attributes
)

JScript

public function GetProperties(
    context : ITypeDescriptorContext, 
    value : Object, 
    attributes : Attribute[]
) : PropertyDescriptorCollection

Parameters

context: Type: System.ComponentModel..::.ITypeDescriptorContext
An ITypeDescriptorContext that provides a format context.

value: Type: System..::.Object
An Object that specifies the type of array for which to get properties.

attributes: Type: array<System..::.Attribute>[]()[]
An array of type Attribute that is used as a filter.

Return Value

Type: System.ComponentModel..::.PropertyDescriptorCollection
A PropertyDescriptorCollection with the properties that are exposed for this data type, or nullNothingnullptra null reference (Nothing in Visual Basic) if there are no properties.

Remarks

As implemented in this class, this method always returns nullNothingnullptra null reference (Nothing in Visual Basic).

Notes to Inheritors:

Override this method if the type you want to convert supports properties.

Use the context parameter to extract additional information about the environment from which this converter is invoked. This parameter can be nullNothingnullptra null reference (Nothing in Visual Basic), so always check it. Also, properties on the context object can return nullNothingnullptra null reference (Nothing in Visual Basic).

The attributes array is used to filter the array. The attributes can have a mix of Type and Attribute objects. Filtering is defined by the following rules:

A Type is treated as a wildcard; it matches a property that has the Type in its set of attributes.
If a property does not have an Attribute of the same class, the property is not included in the returned array.
If the attribute is an instance of Attribute, the property must be an exact match or it is not included in the returned array.
If an Attribute instance is specified and it is the default property, it is included in the returned array even if there is no instance of the Attribute in the property.

Platforms

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.

Version Information

.NET Framework

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

Reference

TypeConverter Class

TypeConverter Members

GetProperties Overload

System.ComponentModel Namespace

ITypeDescriptorContext

Attribute