TypeDescriptionProvider.CreateInstance Method (System.ComponentModel)

.NET Framework Class Library

TypeDescriptionProvider..::.CreateInstance Method

Creates an object that can substitute for another data type.

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

Syntax

Visual Basic (Declaration)

Public Overridable Function CreateInstance ( _
    provider As IServiceProvider, _
    objectType As Type, _
    argTypes As Type(), _
    args As Object() _
) As Object

Visual Basic (Usage)

Dim instance As TypeDescriptionProvider
Dim provider As IServiceProvider
Dim objectType As Type
Dim argTypes As Type()
Dim args As Object()
Dim returnValue As Object

returnValue = instance.CreateInstance(provider, _
    objectType, argTypes, args)

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

Visual C++

public:
virtual Object^ CreateInstance(
    IServiceProvider^ provider, 
    Type^ objectType, 
    array<Type^>^ argTypes, 
    array<Object^>^ args
)

JScript

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

Parameters

provider: Type: System..::.IServiceProvider
An optional service provider.

objectType: Type: System..::.Type
The type of object to create. This parameter is never nullNothingnullptra null reference (Nothing in Visual Basic).

argTypes: Type: array<System..::.Type>[]()[]
An optional array of types that represent the parameter types to be passed to the object's constructor. This array can be nullNothingnullptra null reference (Nothing in Visual Basic) or of zero length.

args: Type: array<System..::.Object>[]()[]
An optional array of parameter values to pass to the object's constructor.

Return Value

Type: System..::.Object
The substitute Object.

Remarks

The IServiceProvider specified by the provider parameter is passed in by the TypeDescriptor..::.CreateInstance method of the TypeDescriptor class. If provider is not nullNothingnullptra null reference (Nothing in Visual Basic), 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 nullNothingnullptra null reference (Nothing in Visual Basic). If provider is nullNothingnullptra null reference (Nothing in Visual Basic), 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.

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

Reference

TypeDescriptionProvider Class

TypeDescriptionProvider Members

System.ComponentModel Namespace

TypeDescriptor..::.CreateInstance