Activator::CreateInstanceFrom Method (String^, String^, array<Object^>^)
Creates an instance of the type whose name is specified, using the named assembly file and default constructor.
Assembly: mscorlib (in mscorlib.dll)
public: static ObjectHandle^ CreateInstanceFrom( String^ assemblyFile, String^ typeName, array<Object^>^ activationAttributes )
Parameters
- assemblyFile
-
Type:
System::String^
The name of a file that contains an assembly where the type named typeName is sought.
- typeName
-
Type:
System::String^
The name of the preferred type.
- activationAttributes
-
Type:
array<System::Object^>^
An array of one or more attributes that can participate in activation. This is typically an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.
This parameter is related to client-activated objects. Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Distributed applications should instead use Windows Communication Foundation.
Return Value
Type: System.Runtime.Remoting::ObjectHandle^A handle that must be unwrapped to access the newly created instance.
| Exception | Condition |
|---|---|
| ArgumentNullException | typeName is null. |
| MissingMethodException | No matching public constructor was found. |
| TypeLoadException | typename was not found in assemblyFile. |
| FileNotFoundException | assemblyFile was not found. |
| MethodAccessException | The caller does not have permission to call this constructor. |
| MemberAccessException | Cannot create an instance of an abstract class, or this member was invoked with a late-binding mechanism. |
| TargetInvocationException | The constructor, which was invoked through reflection, threw an exception. |
| NotSupportedException | activationAttributes is not an empty array, and the type being created does not derive from MarshalByRefObject. |
| SecurityException | The caller does have the required FileIOPermission. |
| BadImageFormatException | assemblyFile is not a valid assembly. -or- The common language runtime (CLR) version 2.0 or later is currently loaded, and assemblyName was compiled for a version of the CLR that is later than the currently loaded version. Note that the .NET Framework versions 2.0, 3.0, and 3.5 all use CLR version 2.0. |
Use the ObjectHandle::Unwrap method to unwrap the return value.
For information about other exceptions that can be thrown by invoked methods, see the Exceptions section of the Assembly::LoadFrom and CreateInstance methods.
for the ability to call unmanaged code when creating an instance of a delegate. Associated enumeration: SecurityPermissionFlag::UnmanagedCode
for the ability to search directory paths and read their contents. Associated enumerations: FileIOPermissionAccess::PathDiscovery and FileIOPermissionAccess::Read
for accessing nonpublic types when the grant set of the nonpublic types is restricted to the caller's grant set or to a subset thereof. Associated enumeration: ReflectionPermissionFlag::RestrictedMemberAccess
for accessing nonpublic types regardless of their grant set. Associated enumeration: ReflectionPermissionFlag::MemberAccess
Available since 1.1