This documentation is archived and is not being maintained.

Assembly.CreateInstance Method (String, Boolean)

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

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

public Object CreateInstance (
	string typeName,
	bool ignoreCase
)
public final Object CreateInstance (
	String typeName, 
	boolean ignoreCase
)
public final function CreateInstance (
	typeName : String, 
	ignoreCase : boolean
) : Object
Not applicable.

Parameters

typeName

The Type.FullName of the type to locate.

ignoreCase

true to ignore the case of the type name; otherwise, false.

Return Value

An instance of Object representing the type, with culture, arguments, binder, and activation attributes set to a null reference (Nothing in Visual Basic), and BindingFlags set to Public or Instance, or a null reference (Nothing in Visual Basic) if typeName is not found.

Exception typeCondition

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.

MissingMethodException

No matching constructor was found.

ArgumentNullException

typeName is a null reference (Nothing in Visual Basic).

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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: