Assembly.CreateInstance Method (String) (System.Reflection)

Switch View :

ScriptFree

.NET Framework Class Library

Assembly.CreateInstance Method (String)

Locates the specified type from this assembly and creates an instance of it using the system activator, using case-sensitive search.

Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic

Public Function CreateInstance ( _
	typeName As String _
) As Object

public Object CreateInstance(
	string typeName
)

Visual C++

public:
virtual Object^ CreateInstance(
	String^ typeName
) sealed

abstract CreateInstance : 
        typeName:string -> Object 
override CreateInstance : 
        typeName:string -> Object

Parameters

typeName: Type: System.String
The Type.FullName of the type to locate.

Return Value

Type: System.Object
An instance of the specified type created with the default constructor; or null if typeName is not found. The type is resolved using the default binder, without specifying culture or activation attributes, and with BindingFlags set to Public or Instance.

Implements

_Assembly.CreateInstance(String)

Exceptions

Exception	Condition
ArgumentException	typeName is an empty string ("") or a string beginning with a null character. -or- The current assembly was loaded into the reflection-only context.
ArgumentNullException	typeName is null.
MissingMethodException	No matching constructor was found.
FileNotFoundException	typeName requires a dependent assembly that could not be found.
FileLoadException	typeName requires a dependent assembly that was found but could not be loaded. -or- The current assembly was loaded into the reflection-only context, and typeName requires a dependent assembly that was not preloaded.
BadImageFormatException	typeName requires a dependent assembly, but the file is not a valid assembly. -or- typeName requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET Framework Security

ReflectionPermission
when invoked late-bound through mechanisms such as Type.InvokeMember. Associated enumeration: ReflectionPermissionFlag.MemberAccess

Platforms

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.

Reference

Assembly Class

CreateInstance Overload

System.Reflection Namespace