This documentation is archived and is not being maintained.

TypeDescriptionProvider.CreateInstance Method

Creates an object that can substitute for another data type.

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

public virtual Object CreateInstance(
	IServiceProvider provider,
	Type objectType,
	Type[] argTypes,
	Object[] args
)

Parameters

provider
Type: System.IServiceProvider
An optional service provider.
objectType
Type: System.Type
The type of object to create. This parameter is never null.
argTypes
Type: System.Type[]
An optional array of types that represent the parameter types to be passed to the object's constructor. This array can be null or of zero length.
args
Type: System.Object[]
An optional array of parameter values to pass to the object's constructor.

Return Value

Type: System.Object
The substitute Object.

The IServiceProvider specified by the provider parameter is passed in by the TypeDescriptor.CreateInstance method of the TypeDescriptor class. If provider is not null, the service provider can be used by the type description provider to obtain additional context about the creation call.

The CreateInstance method is virtual and, by default, returns the result of the Activator.CreateInstance method if provider is null. If provider is null, this method will invoke the CreateInstance method of the parent provider.

Notes to Inheritors

If the derived class is not interested in providing a substitute instance, it should just call the base implementation.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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