AppDomain::Load Method (array<Byte>, array<Byte>)
Assembly: mscorlib (in mscorlib.dll)
public: virtual Assembly^ Load( array<unsigned char>^ rawAssembly, array<unsigned char>^ rawSymbolStore ) sealed
Parameters
- rawAssembly
- Type: array<System::Byte>
An array of type byte that is a COFF-based image containing an emitted assembly.
- rawSymbolStore
- Type: array<System::Byte>
An array of type byte containing the raw bytes representing the symbols for the assembly.
Implements
_AppDomain::Load(array<Byte>, array<Byte>)| Exception | Condition |
|---|---|
| ArgumentNullException | rawAssembly is nullptr. |
| BadImageFormatException | rawAssembly is not a valid assembly. -or- Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version. |
| AppDomainUnloadedException | The operation is attempted on an unloaded application domain. |
| FileLoadException | An assembly or module was loaded twice with two different evidences. |
Beginning with the .NET Framework version 4, the trust level of an assembly that is loaded by using this method is the same as the trust level of the application domain.
This method should be used only to load an assembly into the current application domain. This method is provided as a convenience for interoperability callers who cannot call the static Assembly::Load method. To load assemblies into other application domains, use a method such as CreateInstanceAndUnwrap.
For information that is common to all overloads of this method, see the Load(AssemblyName) method overload.
The following sample demonstrates the use of loading a raw assembly.
For this code example to run, you must provide the fully qualified assembly name. For information about how to obtain the fully qualified assembly name, see Assembly Names.
using namespace System; using namespace System::IO; using namespace System::Reflection; using namespace System::Reflection::Emit; void InstantiateMyType( AppDomain^ domain ) { try { // You must supply a valid fully qualified assembly name here. domain->CreateInstance( "Assembly text name, Version, Culture, PublicKeyToken", "MyType" ); } catch ( Exception^ e ) { Console::WriteLine( e->Message ); } } // Loads the content of a file to a Byte array. array<Byte>^ loadFile( String^ filename ) { FileStream^ fs = gcnew FileStream( filename,FileMode::Open ); array<Byte>^buffer = gcnew array<Byte>((int)fs->Length); fs->Read( buffer, 0, buffer->Length ); fs->Close(); return buffer; } // Creates a dynamic assembly with symbol information // and saves them to temp.dll and temp.pdb void EmitAssembly( AppDomain^ domain ) { AssemblyName^ assemblyName = gcnew AssemblyName; assemblyName->Name = "MyAssembly"; AssemblyBuilder^ assemblyBuilder = domain->DefineDynamicAssembly( assemblyName, AssemblyBuilderAccess::Save ); ModuleBuilder^ moduleBuilder = assemblyBuilder->DefineDynamicModule( "MyModule", "temp.dll", true ); TypeBuilder^ typeBuilder = moduleBuilder->DefineType( "MyType", TypeAttributes::Public ); ConstructorBuilder^ constructorBuilder = typeBuilder->DefineConstructor( MethodAttributes::Public, CallingConventions::Standard, nullptr ); ILGenerator^ ilGenerator = constructorBuilder->GetILGenerator(); ilGenerator->EmitWriteLine( "MyType instantiated!" ); ilGenerator->Emit( OpCodes::Ret ); typeBuilder->CreateType(); assemblyBuilder->Save( "temp.dll" ); } ref class Resolver { public: static Assembly^ MyResolver( Object^ sender, ResolveEventArgs^ args ) { AppDomain^ domain = dynamic_cast<AppDomain^>(sender); // Once the files are generated, this call is // actually no longer necessary. EmitAssembly( domain ); array<Byte>^rawAssembly = loadFile( "temp.dll" ); array<Byte>^rawSymbolStore = loadFile( "temp.pdb" ); Assembly^ assembly = domain->Load( rawAssembly, rawSymbolStore ); return assembly; } }; int main() { AppDomain^ currentDomain = AppDomain::CurrentDomain; InstantiateMyType( currentDomain ); // Failed! currentDomain->AssemblyResolve += gcnew ResolveEventHandler( Resolver::MyResolver ); InstantiateMyType( currentDomain ); // OK! }
- WebPermission
for reading a URI that does not begin with "file://".
- FileIOPermission
for access to read from a file or directory, and for access to the information in the path itself. Associated enumerations: FileIOPermissionAccess::Read, FileIOPermissionAccess::PathDiscovery.
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.