Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TypeDescriptor::AddProvider Method (TypeDescriptionProvider^, Type^)

 

Adds a type description provider for a component class.

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

public:
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")]
static void AddProvider(
	TypeDescriptionProvider^ provider,
	Type^ type
)

Parameters

provider
Type: System.ComponentModel::TypeDescriptionProvider^

The TypeDescriptionProvider to add.

type
Type: System::Type^

The Type of the target component.

Exception Condition
ArgumentNullException

One or both of the parameters are null.

The AddProvider(TypeDescriptionProvider^, Type^) method adds a type description provider that supplies type information for the specified class, derived classes, and all instances of these types.

System_CAPS_noteNote

The type parameter can be any type, including an interface. For example, to provide custom type and instance information for all components, you would specify typeof(IComponent). Passing typeof(object) will call the provider to supply type information for all types.

This method does not maintain a hard reference to any object, so it does not prevent objects from finalizing.

It is possible to add multiple type description providers for the same type or object. If this occurs, the first type description provider encountered that provides type information will be used exclusively. Because type information providers are stored in a stack, the last provider added will be the first one queried. This behavior enables the AddProvider(TypeDescriptionProvider^, Type^) and RemoveProvider methods to be used to push and pop type description providers as required for particular scenarios.

If successful, this method calls the Refresh(Type^) method on the type parameter.

System_CAPS_noteNote

The two versions of this method produce results with different scopes. The AddProvider method that takes an Object parameter affects only that single instance of the component specified. In contrast, the other overload, which takes a Type parameter, affects all instances of the component described by that type.

Use the AddProviderTransparent(TypeDescriptionProvider^, Type^) method if you need to call from partially trusted code.

NamedPermissionSet

for full access to system resources. Demand value: LinkDemand. Associated state:

.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft