Export (0) Print
Expand All

TypeDescriptor.AddProvider Method (TypeDescriptionProvider, Object)

Adds a type description provider for a single instance of a component.

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

[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public static void AddProvider(
	TypeDescriptionProvider provider,
	Object instance
)

Parameters

provider
Type: System.ComponentModel.TypeDescriptionProvider

The TypeDescriptionProvider to add.

instance
Type: System.Object

An instance of the target component.

ExceptionCondition
ArgumentNullException

One or both of the parameters are null.

The AddProvider(TypeDescriptionProvider, Object) method adds a type description provider that supplies type information for a single instance of a component. If a provider is added by this method, the provider's CreateInstance method will not be called because the instance already exists.

This method does not maintain a hard reference to the component, so it does not prevent the component 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. Since type information providers are stored in a stack, the last provider added will be the first one queried. This behavior enables the AddProvider(TypeDescriptionProvider, Object) 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(Object) method on the instance parameter.

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, Object) method if you need to call from partially trusted code.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft