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.
Assembly: mscorlib (in mscorlib.dll)
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^)| 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 that was compiled for a version of the runtime that is later than the currently loaded version. |
If the runtime is unable to find typeName in the Assembly instance, it returns null instead of throwing an exception. This might happen because:
You haven't specified the fully qualified name of the type.
You've specified the fully qualified type name, but its case doesn’t match the case of the type's Type::FullName property. For a case-insensitive comparison of typeName with the type's full name, call the CreateInstance(String^, Boolean) overload and specify true for the ignoreCase argument.
The type doesn’t exist in the current Assembly instance.
when invoked late-bound through mechanisms such as Type::InvokeMember. Associated enumeration: ReflectionPermissionFlag::MemberAccess
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0