Assembly.Load Metodo

Definizione

Carica un assembly.Loads an assembly.

Overload

Load(Byte[], Byte[], SecurityContextSource)

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato, include facoltativamente i simboli e specifica l'origine per il contesto di sicurezza.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

Load(Byte[], Byte[], Evidence)

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli e l'evidenza per l'assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

Load(String, Evidence)

Carica un assembly in base al nome visualizzato nel dominio del chiamante, usando l'evidenza fornita.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

Load(AssemblyName, Evidence)

Carica un assembly dato il relativo oggetto AssemblyName.Loads an assembly given its AssemblyName. L'assembly viene caricato nel dominio del chiamante usando l'evidenza fornita.The assembly is loaded into the domain of the caller using the supplied evidence.

Load(Byte[])

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) contenente un assembly generato.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

Load(String)

Carica un assembly con il nome specificato.Loads an assembly with the specified name.

Load(AssemblyName)

Carica un assembly dato il relativo oggetto AssemblyName.Loads an assembly given its AssemblyName.

Load(Byte[], Byte[])

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli per l'assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

Load(Byte[], Byte[], SecurityContextSource)

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato, include facoltativamente i simboli e specifica l'origine per il contesto di sicurezza.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::SecurityContextSource securityContextSource);
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.SecurityContextSource securityContextSource);
static member Load : byte[] * byte[] * System.Security.SecurityContextSource -> System.Reflection.Assembly

Parametri

rawAssembly
Byte[]

Matrice di byte costituita da un'immagine in formato COFF contenente un assembly generato.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matrice di byte contenente i byte non elaborati che rappresentano i simboli per l'assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

securityContextSource
SecurityContextSource

Origine del contesto di sicurezza.The source of the security context.

Restituisce

Assembly caricato.The loaded assembly.

Eccezioni

rawAssembly è null.rawAssembly is null.

rawAssembly non è un assembly valido.rawAssembly is not a valid assembly.

-oppure--or- rawAssembly è stato compilato con una versione successiva di Common Language Runtime rispetto alla versione attualmente caricata.rawAssembly was compiled with a later version of the common language runtime than the version that is currently loaded.

Il valore di securityContextSource non è uno dei valori di enumerazione.The value of securityContextSource is not one of the enumeration values.

Commenti

L'assembly viene caricato nel dominio applicazione del chiamante utilizzando l'origine specificata per il contesto di sicurezza.The assembly is loaded into the application domain of the caller using the specified source for the security context. Se rawSymbolStore è stato specificato, vengono caricati anche i byte non elaborati che rappresentano i simboli per l'assembly.If rawSymbolStore was specified, the raw bytes that represent the symbols for the assembly are also loaded.

Load(Byte[], Byte[], Evidence)

Avviso

Questa API è ora obsoleta.

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli e l'evidenza per l'assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::Policy::Evidence ^ securityEvidence);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);
static member Load : byte[] * byte[] * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte(), securityEvidence As Evidence) As Assembly

Parametri

rawAssembly
Byte[]

Matrice di byte costituita da un'immagine in formato COFF contenente un assembly generato.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matrice di byte contenente i byte non elaborati che rappresentano i simboli per l'assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

securityEvidence
Evidence

Evidenza per il caricamento dell'assembly.Evidence for loading the assembly.

Restituisce

Assembly caricato.The loaded assembly.

Attributi

Eccezioni

rawAssembly è null.rawAssembly is null.

rawAssembly non è un assembly valido.rawAssembly is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto rawAssembly è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Un assembly o un modulo è stato caricato due volte con due evidenze diverse.An assembly or module was loaded twice with two different evidences.

securityEvidence non è null.securityEvidence is not null. Per impostazione predefinita, i criteri di sicurezza dall'accesso di codice legacy non sono abilitati in .NET Framework 4.NET Framework 4; quando non sono abilitati, securityEvidence deve essere null.By default, legacy CAS policy is not enabled in the .NET Framework 4.NET Framework 4; when it is not enabled, securityEvidence must be null.

Commenti

L'assembly viene caricato nel dominio del chiamante usando l'evidenza fornita.The assembly is loaded into the domain of the caller using the supplied evidence. Vengono caricati anche i byte non elaborati che rappresentano i simboli per l'assembly.The raw bytes representing the symbols for the assembly are also loaded.

Se sussistano o meno le autorizzazioni per l'utilizzo di un assembly lo si evince dalle evidenze.Whether certain permissions are granted or not granted to an assembly is based on evidence. Di seguito sono riportate le regole per l'Unione delle evidenze di assembly e sicurezza:The rules for assembly and security evidence merging are as follows:

  • Quando si usa un Load metodo senza Evidence parametro, l'assembly viene caricato con l'evidenza fornita dal caricatore.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando si usa un metodo di Load con un parametro di Evidence, vengono uniti elementi di evidenza.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Parti di evidenza fornite come argomento al metodo Load sostituiscono le parti di evidenza fornite dal caricatore.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene ereditata dall'assembly chiamante.When you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is inherited from the calling assembly. Questo vale per la versione di .NET Framework 1,1 Service Pack 1 (SP1) e per le versioni successive.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    In .NET Framework versione 1,0 e nella versione 1,1 senza SP1, quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene combinata.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url e Site vengono ereditati dall'assembly chiamante e Hash e StrongName vengono ricavati dall'assembly COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando si utilizza un metodo di Load con un parametro di Byte[] e Evidence per caricare un'immagine COFF, viene utilizzata solo l'evidenza fornita.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. L'evidenza dell'assembly chiamante e l'evidenza dell'immagine COFF verranno ignorate.Evidence of the calling assembly and evidence of the COFF image are ignored.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Se si chiama il metodo [], byte<xrif: System. Reflection. assembly. Load% 2A > più di una volta nello stesso assembly ma con un'evidenza diversa specificata, il Common Language Runtime non genera un'FileLoadException perché l'uguaglianza e l'integrità non è possibile determinare le diverse specifiche di evidenza.If you call the [], Byte<xref:System.Reflection.Assembly.Load%2A> method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. L'evidenza che ha prima esito positivo è l'evidenza che viene utilizzata.The evidence that first succeeds is the evidence that is used.

Si noti che questo overload del metodo crea sempre un nuovo oggetto Assembly con il proprio mapping.Note that this method overload always creates a new Assembly object with its own mapping.

Sicurezza

SecurityPermission
per la possibilità di fornire evidenza.for the ability to supply evidence. Enumerazione associata: ControlEvidence.Associated enumeration: ControlEvidence. Azione di sicurezza: Demand.Security action: Demand.

Load(String, Evidence)

Avviso

Questa API è ora obsoleta.

Carica un assembly in base al nome visualizzato nel dominio del chiamante, usando l'evidenza fornita.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (string assemblyString, System.Security.Policy.Evidence assemblySecurity);
static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyString As String, assemblySecurity As Evidence) As Assembly

Parametri

assemblyString
String

Nome visualizzato dell'assembly.The display name of the assembly.

assemblySecurity
Evidence

Evidenza per il caricamento dell'assembly.Evidence for loading the assembly.

Restituisce

Assembly caricato.The loaded assembly.

Attributi

Eccezioni

assemblyString è null.assemblyString is null.

assemblyString non trovata.assemblyString is not found.

assemblyString non è un assembly valido.assemblyString is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto assemblyString è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Non è stato possibile caricare un file trovato.A file that was found could not be loaded.

-oppure--or-

Un assembly o un modulo è stato caricato due volte con due evidenze diverse.An assembly or module was loaded twice with two different evidences.

Commenti

FileLoadException viene generata se assemblyString specifica il nome completo dell'assembly e il primo assembly che corrisponde al nome semplice ha una versione, una lingua o un token di chiave pubblica diversi.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Il caricatore non continua il sondaggio per gli altri assembly che corrispondono al nome semplice.The loader does not continue probing for other assemblies that match the simple name.

Se sussistano o meno le autorizzazioni per l'utilizzo di un assembly lo si evince dalle evidenze.Whether certain permissions are granted or not granted to an assembly is based on evidence. Di seguito sono riportate le regole per l'Unione delle evidenze di assembly e sicurezza:The rules for assembly and security evidence merging are as follows:

  • Quando si usa un Load metodo senza Evidence parametro, l'assembly viene caricato con l'evidenza fornita dal caricatore.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando si usa un metodo di Load con un parametro di Evidence, vengono uniti elementi di evidenza.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Parti di evidenza fornite come argomento al metodo Load sostituiscono le parti di evidenza fornite dal caricatore.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine di Common Object File Format (COFF), l'evidenza viene ereditata dall'assembly chiamante.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Questo vale per la versione di .NET Framework 1,1 Service Pack 1 (SP1) e per le versioni successive.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    In .NET Framework versione 1,0 e nella versione 1,1 senza SP1, quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene combinata.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url e Site vengono ereditati dall'assembly chiamante e Hash e StrongName vengono ricavati dall'assembly COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando si utilizza un metodo di Load con un parametro di Byte[] e Evidence per caricare un'immagine COFF, viene utilizzata solo l'evidenza fornita.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. L'evidenza dell'assembly chiamante e dell'evidenza dell'immagine COFF viene ignorata.Evidence of the calling assembly and evidence of the COFF image is ignored.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Se si chiama questo metodo più di una volta nello stesso assembly ma con un'altra evidenza specificata, il Common Language Runtime non genera un'FileLoadException perché non è possibile determinare l'uguaglianza e l'integrità delle diverse specifiche di evidenza.If you call this method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. L'evidenza che ha prima esito positivo è l'evidenza che viene utilizzata.The evidence that first succeeds is the evidence that is used.

In .NET Framework versione 2,0, l'architettura del processore viene aggiunta all'identità dell'assembly e può essere specificata come parte delle stringhe dei nomi degli assembly.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Ad esempio, "ProcessorArchitecture = msil".For example, "ProcessorArchitecture=msil". Tuttavia, la modalità consigliata per specificare un nome di assembly consiste nel creare un AssemblyName oggetto e passarlo a un overload appropriato del metodo Load.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. Vedere AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Sicurezza

SecurityPermission
per caricare un assembly con evidenze.to load an assembly with evidence. Enumerazione associata: ControlEvidenceAssociated enumeration: ControlEvidence

Vedi anche

Load(AssemblyName, Evidence)

Avviso

Questa API è ora obsoleta.

Carica un assembly dato il relativo oggetto AssemblyName.Loads an assembly given its AssemblyName. L'assembly viene caricato nel dominio del chiamante usando l'evidenza fornita.The assembly is loaded into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);
static member Load : System.Reflection.AssemblyName * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName, assemblySecurity As Evidence) As Assembly

Parametri

assemblyRef
AssemblyName

Oggetto che descrive l'assembly da caricare.The object that describes the assembly to be loaded.

assemblySecurity
Evidence

Evidenza per il caricamento dell'assembly.Evidence for loading the assembly.

Restituisce

Assembly caricato.The loaded assembly.

Attributi

Eccezioni

assemblyRef è null.assemblyRef is null.

assemblyRef non trovata.assemblyRef is not found.

assemblyRef non è un assembly valido.assemblyRef is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto assemblyRef è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Un assembly o un modulo è stato caricato due volte con due evidenze diverse.An assembly or module was loaded twice with two different evidences.

-oppure--or-

assemblyRef specifica un assembly remoto, ma la possibilità di eseguire codice negli assembly remoti è disabilitata.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Vedere <loadFromRemoteSources>.See <loadFromRemoteSources>.

Commenti

FileLoadException viene generata se assemblyRef specifica il nome completo dell'assembly e il primo assembly che corrisponde al nome semplice ha una versione, una lingua o un token di chiave pubblica diversi.FileLoadException is thrown if assemblyRef specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Il caricatore non continua il sondaggio per gli altri assembly che corrispondono al nome semplice.The loader does not continue probing for other assemblies that match the simple name. A partire da .NET Framework 4, poiché l'esecuzione del codice negli assembly remoti è disabilitata per impostazione predefinita, viene generata anche una FileLoadException se assemblyRef specifica un assembly remoto.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Per consentire l'esecuzione del codice caricato da posizioni remote, è possibile usare l'elemento di configurazione <loadFromRemoteSources> .To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Nota

Non usare un AssemblyName solo con il set di proprietà CodeBase.Do not use an AssemblyName with only the CodeBase property set. La proprietà CodeBase non fornisce elementi dell'identità dell'assembly (ad esempio nome o versione), pertanto il caricamento non viene eseguito in base alle regole di caricamento per identità, come previsto dal metodo Load.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. L'assembly viene invece caricato usando le regole di caricamento.Instead, the assembly is loaded using load-from rules. Per informazioni sugli svantaggi dell'utilizzo del contesto di caricamento, vedere il Assembly.LoadFrom overload del metodo o le procedure consigliate per il caricamento di assembly.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

Se sussistano o meno le autorizzazioni per l'utilizzo di un assembly lo si evince dalle evidenze.Whether certain permissions are granted or not granted to an assembly is based on evidence. Di seguito sono riportate le regole per l'Unione delle evidenze di assembly e sicurezza:The rules for assembly and security evidence merging are as follows:

  • Quando si usa un Load metodo senza Evidence parametro, l'assembly viene caricato con l'evidenza fornita dal caricatore.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando si usa un metodo di Load con un parametro di Evidence, vengono uniti elementi di evidenza.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Parti di evidenza fornite come argomento al metodo Load sostituiscono le parti di evidenza fornite dal caricatore.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine di Common Object File Format (COFF), l'evidenza viene ereditata dall'assembly chiamante.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Questo vale per la versione di .NET Framework 1,1 Service Pack 1 (SP1) e per le versioni successive.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    In .NET Framework versione 1,0 e nella versione 1,1 senza SP1, quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene combinata.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url e Site vengono ereditati dall'assembly chiamante e Hash e StrongName vengono ricavati dall'assembly COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando si utilizza un metodo di Load con un parametro di Byte[] e Evidence per caricare un'immagine COFF, viene utilizzata solo l'evidenza fornita.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. L'evidenza dell'assembly chiamante e dell'evidenza dell'immagine COFF viene ignorata.Evidence of the calling assembly and evidence of the COFF image is ignored.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Nota

Se entrambe le proprietà AssemblyName.Name e AssemblyName.CodeBase sono impostate, il primo tentativo di caricamento dell'assembly utilizzerà il nome visualizzato (incluse la versione, le impostazioni cultura e così via, come restituito dalla proprietà Assembly.FullName).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Se il file non viene trovato, CodeBase viene usato per cercare l'assembly.If the file is not found, CodeBase is used to search for the assembly. Se l'assembly viene trovato utilizzando CodeBase, il nome visualizzato viene associato all'assembly.If the assembly is found using CodeBase, the display name is matched against the assembly. Se la corrispondenza ha esito negativo, viene generata un'FileLoadException.If the match fails, a FileLoadException is thrown.

Se si chiama il metodo Load più di una volta nello stesso assembly, ma con un'altra evidenza specificata, il Common Language Runtime non genera un FileLoadException perché non è possibile determinare l'uguaglianza e l'integrità delle diverse specifiche di evidenza.If you call the Load method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. L'evidenza che ha prima esito positivo è l'evidenza che viene utilizzata.The evidence that first succeeds is the evidence that is used.

Sicurezza

FileIOPermission
per accedere a leggere da un file o da una directory e per accedere alle informazioni nel percorso stesso.for access to read from a file or directory, and for access to the information in the path itself. Enumerazioni associate: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
per la lettura di un URI che non inizia con "file://".for reading a URI that does not begin with "file://".

SecurityPermission
per caricare un assembly con evidenze.to load an assembly with evidence. Enumerazione associata: ControlEvidenceAssociated enumeration: ControlEvidence

Vedi anche

Load(Byte[])

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) contenente un assembly generato.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly);
public static System.Reflection.Assembly Load (byte[] rawAssembly);
static member Load : byte[] -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte()) As Assembly

Parametri

rawAssembly
Byte[]

Matrice di byte costituita da un'immagine in formato COFF contenente un assembly generato.A byte array that is a COFF-based image containing an emitted assembly.

Restituisce

Assembly caricato.The loaded assembly.

Eccezioni

rawAssembly è null.rawAssembly is null.

rawAssembly non è un assembly valido.rawAssembly is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto rawAssembly è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Commenti

Il livello di attendibilità di un assembly caricato utilizzando questo metodo è uguale al livello di attendibilità dell'assembly chiamante.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Per caricare un assembly da una matrice di byte con il livello di attendibilità del dominio dell'applicazione, usare l'overload del metodo Load(Byte[], Byte[], SecurityContextSource).To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Per ulteriori informazioni sull'utilizzo dell'evidenza con overload del metodo Load che accettano matrici di byte, vedere l'overload del metodo Load(Byte[], Byte[], Evidence).For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Si noti che questo overload del metodo crea sempre un nuovo oggetto Assembly con il proprio mapping.Note that this method overload always creates a new Assembly object with its own mapping.

Load(String)

Carica un assembly con il nome specificato.Loads an assembly with the specified name.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString);
public static System.Reflection.Assembly Load (string assemblyString);
static member Load : string -> System.Reflection.Assembly
Public Shared Function Load (assemblyString As String) As Assembly

Parametri

assemblyString
String

Forma estesa o breve del nome dell'assembly.The long or short form of the assembly name.

Restituisce

Assembly caricato.The loaded assembly.

Eccezioni

assemblyString è null.assemblyString is null.

assemblyString è una stringa di lunghezza zero.assemblyString is a zero-length string.

assemblyString non trovata.assemblyString is not found.

Non è stato possibile caricare un file trovato.A file that was found could not be loaded.

assemblyString non è un assembly valido.assemblyString is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto assemblyString è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Esempi

Nell'esempio seguente viene caricato un assembly in base al nome completo ed elencati tutti i tipi contenuti nell'assembly specificato.The following example loads an assembly given its fully qualified name, and lists all the types contained in the specified assembly. Per informazioni su come ottenere il nome completo dell'assembly, vedere nomi degli assembly.For information about how to obtain the fully qualified assembly name, see Assembly Names.

using namespace System;
using namespace System::Collections;
using namespace System::Reflection;
int main()
{
    // You must supply a valid fully qualified assembly name.            
    Assembly^ SampleAssembly = Assembly::Load
        ( "SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3" );
    array<Type^>^ Types = SampleAssembly->GetTypes();
    
    // Display all the types contained in the specified assembly.
    IEnumerator^ myEnum = Types->GetEnumerator();
    Type^ oType;
    while ( myEnum->MoveNext() )
    {
        oType = safe_cast<Type^>(myEnum->Current);
        Console::WriteLine( oType->Name );
    }
}

using System;
using System.Reflection;

class Class1
{
    public static void Main()
    {
        // You must supply a valid fully qualified assembly name.            
        Assembly SampleAssembly = Assembly.Load
            ("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3");
        // Display all the types contained in the specified assembly.
        foreach (Type oType in SampleAssembly.GetTypes()) {
            Console.WriteLine(oType.Name);
        }
    }
}
Imports System.Reflection

Class Class1
    Public Shared Sub Main()
        ' You must supply a valid fully qualified assembly name.            
        Dim SampleAssembly As [Assembly] = _
            [Assembly].Load("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3")
        Dim oType As Type
        ' Display all the types contained in the specified assembly.
        For Each oType In SampleAssembly.GetTypes()
            Console.WriteLine(oType.Name)
        Next oType
    End Sub	'LoadSample
End Class

Commenti

Per caricare l'assembly corretto, è consigliabile chiamare il metodo Load passando la forma estesa del nome dell'assembly.To load the correct assembly, it's recommended to call the Load method by passing the long form of the assembly name. La forma estesa del nome di un assembly è costituita dal nome semplice (ad esempio "System" per l'assembly System. dll) insieme alla relativa versione, alle impostazioni cultura, al token di chiave pubblica e, facoltativamente, all'architettura del processore.The long form of an assembly name consists of its simple name (such as "System" for the System.dll assembly) along with its version, culture, public key token, and optionally its processor architecture. Corrisponde alla proprietà FullName dell'assembly.It corresponds to the assembly's FullName property. Nell'esempio seguente viene illustrato l'utilizzo di un nome lungo per caricare l'assembly System. dll per il .NET Framework 4:The following example illustrates the use of a long name to load the System.dll assembly for the .NET Framework 4:

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      string longName = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089";
      Assembly assem = Assembly.Load(longName);
      if (assem == null)
         Console.WriteLine("Unable to load assembly...");
      else
         Console.WriteLine(assem.FullName);
   }
}
// The example displays the following output:
//        system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim longName As String = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
      Dim assem As Assembly = Assembly.Load(longName)
      If assem Is Nothing Then
         Console.WriteLine("Unable to load assembly...")
      Else
         Console.WriteLine(assem.FullName)
      End If
   End Sub
End Module
' The example displays the following output:
'       system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

FileLoadException viene generata se assemblyString specifica il nome completo dell'assembly e il primo assembly che corrisponde al nome semplice ha una versione, una lingua o un token di chiave pubblica diversi.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. Il caricatore non continua il sondaggio per gli altri assembly che corrispondono al nome semplice.The loader does not continue probing for other assemblies that match the simple name.

Se sussistano o meno le autorizzazioni per l'utilizzo di un assembly lo si evince dalle evidenze.Whether certain permissions are granted or not granted to an assembly is based on evidence. Di seguito sono riportate le regole per l'Unione delle evidenze di assembly e sicurezza:The rules for assembly and security evidence merging are as follows:

  • Quando si usa un Load metodo senza Evidence parametro, l'assembly viene caricato con l'evidenza fornita dal caricatore.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando si usa un metodo di Load con un parametro di Evidence, vengono uniti elementi di evidenza.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Parti di evidenza fornite come argomento al metodo Load sostituiscono le parti di evidenza fornite dal caricatore.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine di Common Object File Format (COFF), l'evidenza viene ereditata dall'assembly chiamante.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Questo vale per la versione di .NET Framework 1,1 Service Pack 1 (SP1) e per le versioni successive.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    In .NET Framework versione 1,0 e nella versione 1,1 senza SP1, quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene combinata.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url e Site vengono ereditati dall'assembly chiamante e Hash e StrongName vengono ricavati dall'assembly COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando si utilizza un metodo di Load con un parametro di Byte[] e Evidence per caricare un'immagine COFF, viene utilizzata solo l'evidenza fornita.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. L'evidenza dell'assembly chiamante e dell'evidenza dell'immagine COFF viene ignorata.Evidence of the calling assembly and evidence of the COFF image is ignored.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

In .NET Framework versione 2,0, l'architettura del processore viene aggiunta all'identità dell'assembly e può essere specificata come parte delle stringhe dei nomi degli assembly.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Ad esempio, "ProcessorArchitecture = msil".For example, "ProcessorArchitecture=msil". Tuttavia, la modalità consigliata per specificare un nome di assembly consiste nel creare un AssemblyName oggetto e passarlo a un overload appropriato del metodo Load.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. Vedere AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Sicurezza

SecurityPermission
per caricare un assembly con evidenze.to load an assembly with evidence. Enumerazione associata: ControlEvidenceAssociated enumeration: ControlEvidence

Vedi anche

Load(AssemblyName)

Carica un assembly dato il relativo oggetto AssemblyName.Loads an assembly given its AssemblyName.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef);
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef);
static member Load : System.Reflection.AssemblyName -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName) As Assembly

Parametri

assemblyRef
AssemblyName

Oggetto che descrive l'assembly da caricare.The object that describes the assembly to be loaded.

Restituisce

Assembly caricato.The loaded assembly.

Eccezioni

assemblyRef è null.assemblyRef is null.

assemblyRef non trovata.assemblyRef is not found.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

Non è stato possibile caricare un file trovato.A file that was found could not be loaded.

-oppure--or-

assemblyRef specifica un assembly remoto, ma la possibilità di eseguire codice negli assembly remoti è disabilitata.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Vedere <loadFromRemoteSources>.See <loadFromRemoteSources>.

assemblyRef non è un assembly valido.assemblyRef is not a valid assembly. -oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto assemblyRef è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Esempi

Nell'esempio seguente viene creata un'istanza di un oggetto AssemblyName e viene utilizzato per caricare l'assembly di sysglobal.dll.The following example instantiates an AssemblyName object and uses it to load the sysglobal.dll assembly. Nell'esempio viene quindi visualizzato il nome completo dei tipi pubblici dell'assembly.The example then displays the full name of the assembly's public types.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      String fullName = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                        "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL";
      var an = new AssemblyName(fullName);
      var assem = Assembly.Load(an);
      Console.WriteLine("Public types in assembly {0}:", assem.FullName);
      foreach (var t in assem.GetTypes())
         if (t.IsPublic)
            Console.WriteLine("   {0}", t.FullName);
   }
}
// The example displays the following output:
//   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
//      System.Globalization.CultureAndRegionInfoBuilder
//      System.Globalization.CultureAndRegionModifiers
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim fullName As String = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                               "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL"
      Dim an As New AssemblyName(fullName)
      Dim assem As Assembly = Assembly.Load(an)
      Console.WriteLine("Public types in assembly {0}:", assem.FullName)
      For Each t As Type in assem.GetTypes()
         If t.IsPublic Then Console.WriteLine("   {0}", t.FullName)
      Next
   End Sub
End Module
' The example displays the following output:
'   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
'      System.Globalization.CultureAndRegionInfoBuilder
'      System.Globalization.CultureAndRegionModifiers

Commenti

FileLoadException viene generata se assemblyRef specifica il nome completo dell'assembly e il primo assembly che corrisponde al nome semplice ha una versione, una lingua o un token di chiave pubblica differenti.FileLoadException is thrown if assemblyRef specifies the full assembly name and the first assembly that matches the simple name has a different version, culture, or public key token. Il caricatore non continua il sondaggio per gli altri assembly che corrispondono al nome semplice.The loader does not continue probing for other assemblies that match the simple name. A partire da .NET Framework 4, poiché l'esecuzione del codice negli assembly remoti è disabilitata per impostazione predefinita, viene generata anche una FileLoadException se assemblyRef specifica un assembly remoto.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Per consentire l'esecuzione del codice caricato da posizioni remote, è possibile usare l'elemento di configurazione <loadFromRemoteSources> .To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Nota

Non usare un AssemblyName solo con il set di proprietà CodeBase.Do not use an AssemblyName with only the CodeBase property set. La proprietà CodeBase non fornisce elementi dell'identità dell'assembly (ad esempio nome o versione), pertanto il caricamento non viene eseguito in base alle regole di caricamento per identità, come previsto dal metodo Load.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. L'assembly viene invece caricato usando le regole di caricamento.Instead, the assembly is loaded using load-from rules. Per informazioni sugli svantaggi dell'utilizzo del contesto di caricamento, vedere il Assembly.LoadFrom overload del metodo o le procedure consigliate per il caricamento di assembly.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

Se sussistano o meno le autorizzazioni per l'utilizzo di un assembly lo si evince dalle evidenze.Whether certain permissions are granted or not granted to an assembly is based on evidence. Di seguito sono riportate le regole per l'Unione delle evidenze di assembly e sicurezza:The rules for assembly and security evidence merging are as follows:

  • Quando si usa un Load metodo senza Evidence parametro, l'assembly viene caricato con l'evidenza fornita dal caricatore.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando si usa un metodo di Load con un parametro di Evidence, vengono uniti elementi di evidenza.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Parti di evidenza fornite come argomento al metodo Load sostituiscono le parti di evidenza fornite dal caricatore.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine di Common Object File Format (COFF), l'evidenza viene ereditata dall'assembly chiamante.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Questo vale per la versione di .NET Framework 1,1 Service Pack 1 (SP1) e per le versioni successive.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    In .NET Framework versione 1,0 e nella versione 1,1 senza SP1, quando si usa un overload del metodo Load con un parametro Byte[] per caricare un'immagine COFF, l'evidenza viene combinata.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url e Site vengono ereditati dall'assembly chiamante e Hash e StrongName vengono ricavati dall'assembly COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando si utilizza un metodo di Load con un parametro di Byte[] e Evidence per caricare un'immagine COFF, viene utilizzata solo l'evidenza fornita.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. L'evidenza dell'assembly chiamante e dell'evidenza dell'immagine COFF viene ignorata.Evidence of the calling assembly and evidence of the COFF image is ignored.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Nota

Se entrambe le proprietà AssemblyName.Name e AssemblyName.CodeBase sono impostate, il primo tentativo di caricamento dell'assembly utilizzerà il nome visualizzato (incluse la versione, le impostazioni cultura e così via, come restituito dalla proprietà Assembly.FullName).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Se il file non viene trovato, CodeBase viene usato per cercare l'assembly.If the file is not found, CodeBase is used to search for the assembly. Se l'assembly viene trovato utilizzando CodeBase, il nome visualizzato viene associato all'assembly.If the assembly is found using CodeBase, the display name is matched against the assembly. Se la corrispondenza ha esito negativo, viene generata un'FileLoadException.If the match fails, a FileLoadException is thrown.

Sicurezza

FileIOPermission
per accedere a leggere da un file o da una directory e per accedere alle informazioni nel percorso stesso.for access to read from a file or directory, and for access to the information in the path itself. Enumerazioni associate: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
per la lettura di un URI che non inizia con "file://".for reading a URI that does not begin with "file://".

SecurityPermission
per caricare un assembly con evidenze.to load an assembly with evidence. Enumerazione associata: ControlEvidenceAssociated enumeration: ControlEvidence

Vedi anche

Load(Byte[], Byte[])

Carica l'assembly con un'immagine in formato COFF (Common Object File Format) che contiene un assembly generato e include facoltativamente i simboli per l'assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. L'assembly viene caricato nel dominio applicazione del chiamante.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore);
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore);
static member Load : byte[] * byte[] -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte()) As Assembly

Parametri

rawAssembly
Byte[]

Matrice di byte costituita da un'immagine in formato COFF contenente un assembly generato.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matrice di byte contenente i byte non elaborati che rappresentano i simboli per l'assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

Restituisce

Assembly caricato.The loaded assembly.

Eccezioni

rawAssembly è null.rawAssembly is null.

rawAssembly non è un assembly valido.rawAssembly is not a valid assembly.

-oppure--or- Attualmente è caricata la versione 2.0 o successiva di Common Language Runtime e l'oggetto rawAssembly è stato compilato con una versione successiva.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Commenti

Il livello di attendibilità di un assembly caricato utilizzando questo metodo è uguale al livello di attendibilità dell'assembly chiamante.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Per caricare un assembly da una matrice di byte con il livello di attendibilità del dominio dell'applicazione, usare l'overload del metodo Load(Byte[], Byte[], SecurityContextSource).To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Per ulteriori informazioni sull'utilizzo dell'evidenza con overload del metodo Load che accettano matrici di byte, vedere l'overload del metodo Load(Byte[], Byte[], Evidence).For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

La reflection su C++ file eseguibili potrebbe generare un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Questo è probabilmente dovuto al fatto che C++ il compilatore rimuove gli indirizzi di rilocazione o la sezione .reloc dal file eseguibile.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Per mantenere l'indirizzo .reloc per il C++ file eseguibile, specificare /fixed:no quando si sta collegando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Si noti che questo overload del metodo crea sempre un nuovo oggetto Assembly con il proprio mapping.Note that this method overload always creates a new Assembly object with its own mapping.

Si applica a