CollectionConverter.GetProperties Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a collection of properties for the type of array specified by the value parameter using the specified context and attributes.
public:
override System::ComponentModel::PropertyDescriptorCollection ^ GetProperties(System::ComponentModel::ITypeDescriptorContext ^ context, System::Object ^ value, cli::array <Attribute ^> ^ attributes);
public override System.ComponentModel.PropertyDescriptorCollection GetProperties (System.ComponentModel.ITypeDescriptorContext context, object value, Attribute[] attributes);
public override System.ComponentModel.PropertyDescriptorCollection GetProperties (System.ComponentModel.ITypeDescriptorContext? context, object value, Attribute[]? attributes);
override this.GetProperties : System.ComponentModel.ITypeDescriptorContext * obj * Attribute[] -> System.ComponentModel.PropertyDescriptorCollection
Public Overrides Function GetProperties (context As ITypeDescriptorContext, value As Object, attributes As Attribute()) As PropertyDescriptorCollection
Parameters
- context
- ITypeDescriptorContext
An ITypeDescriptorContext that provides a format context.
Returns
A PropertyDescriptorCollection with the properties that are exposed for this data type, or null
if there are no properties. This method always returns null
.
Remarks
The context
parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null
, so always check. Also, properties on the context object can return null
.
The attributes array that you pass in will be 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 object will be treated as a wildcard; it will match 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 or it will not be included in the returned array.
If an Attribute instance is specified 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.
Collections do not support properties; therefore, this method always returns null
.