Click or drag to resize
ActivatorCreateInstance Method (Type, Object, Object)
Creates an instance of the specified type using the constructor that best matches the specified parameters.

Namespace: System
Assembly: mscorlib (in mscorlib.dll) Version: 4.0.0.0
Syntax
C#
public static Object CreateInstance(
	Type type,
	Object[] args,
	Object[] activationAttributes
)

Parameters

type
Type: SystemType
The type of object to create.
args
Type: SystemObject
An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If args is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked.
activationAttributes
Type: SystemObject
An array of one or more attributes that can participate in activation. This is typically an array that contains a single UrlAttribute object. The UrlAttribute specifies the URL that is required to activate a remote object.

Return Value

Type: Object
A reference to the newly created object.
Exceptions
ExceptionCondition
ArgumentNullExceptiontype is null.
ArgumentExceptiontype is not a RuntimeType. -or-type is an open generic type (that is, the ContainsGenericParameters property returns true).
NotSupportedExceptiontype cannot be a TypeBuilder.-or- Creation of TypedReference, ArgIterator, Void, and RuntimeArgumentHandle types, or arrays of those types, is not supported.-or- activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject. -or-The assembly that contains type is a dynamic assembly that was created with Save.-or-The constructor that best matches args has varargs arguments.
TargetInvocationExceptionThe constructor being called throws an exception.
MethodAccessExceptionThe caller does not have permission to call this constructor.
MemberAccessExceptionCannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism.
InvalidComObjectExceptionThe COM type was not obtained through GetTypeFromProgID or GetTypeFromCLSID.
MissingMethodExceptionNo matching public constructor was found.
COMExceptiontype is a COM object but the class identifier used to obtain the type is invalid, or the identified class is not registered.
TypeLoadExceptiontype is not a valid type.
See Also