System.AppDomain.CreateInstance Method

Creates a new instance of the specified type defined in the specified assembly.

Syntax

public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName)

Parameters

assemblyName
The display name of the assembly. See System.Reflection.Assembly.FullName.
typeName
The fully qualified name of the requested type, including the namespace but not the assembly, as returned by the Type.FullName property.

Returns

An object that is a wrapper for the new instance specified by typeName. The return value needs to be unwrapped to access the real object.

Remarks

This method calls the default constructor for typeName.

See System.Reflection.AssemblyName for the format of assemblyName.

An attempt to call AppDomain.CreateInstance(string, string) on a target application domain that is not the current application domain will result in a successful load of the assembly in the target application domain. Since an System.Reflection.Assembly is not MarshalByRefObject, when this method attempts to return the System.Reflection.Assembly for the loaded assembly to the current application domain, the common language runtime will try to load the assembly into the current application domain and the load might fail. The assembly that is loaded into the current application domain might be different from the assembly that was loaded first if the path settings for the two application domains are different.

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0