Assembly.Load Assembly.Load Assembly.Load Assembly.Load Method

Definição

Carrega um assembly.Loads an assembly.

Sobrecargas

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

Carrega o assembly com uma imagem baseada no formato COFF contendo um assembly emitido, opcionalmente incluindo símbolos e especificando a fonte para o contexto de segurança.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. O assembly é carregado no domínio de aplicativo do chamador.The assembly is loaded into the application domain of the caller.

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

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido, incluindo, opcionalmente, símbolos e evidência para o 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. O assembly é carregado no domínio de aplicativo do chamador.The assembly is loaded into the application domain of the caller.

Load(String, Evidence) Load(String, Evidence) Load(String, Evidence) Load(String, Evidence)

Carrega um assembly dado seu nome de exibição, carregando-o no domínio do chamador usando a evidência fornecida.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence)

Carrega um assembly de acordo com seu AssemblyName.Loads an assembly given its AssemblyName. O assembly é carregado no domínio do chamador usando a evidência fornecida.The assembly is loaded into the domain of the caller using the supplied evidence.

Load(Byte[]) Load(Byte[]) Load(Byte[]) Load(Byte[])

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. O assembly é carregado no domínio de aplicativo do chamador.The assembly is loaded into the application domain of the caller.

Load(String) Load(String) Load(String) Load(String)

Carrega um assembly tendo o formato longo de seu nome.Loads an assembly given the long form of its name.

Load(AssemblyName) Load(AssemblyName) Load(AssemblyName) Load(AssemblyName)

Carrega um assembly de acordo com seu AssemblyName.Loads an assembly given its AssemblyName.

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

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido e com a opção de incluir símbolos para o assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. O assembly é carregado no domínio de aplicativo do chamador.The assembly is loaded into the application domain of the caller.

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

Carrega o assembly com uma imagem baseada no formato COFF contendo um assembly emitido, opcionalmente incluindo símbolos e especificando a fonte para o contexto de segurança.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. O assembly é carregado no domínio de aplicativo do chamador.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

Parâmetros

rawAssembly
Byte[]

Uma matriz de byte que é uma imagem baseada em COFF contendo um assembly emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Uma matriz de bytes que contém os bytes brutos que representam os símbolos do assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

securityContextSource
SecurityContextSource SecurityContextSource SecurityContextSource SecurityContextSource

A origem do contexto de segurança.The source of the security context.

Retornos

O assembly carregado.The loaded assembly.

Exceções

rawAssembly não é um assembly válido.rawAssembly is not a valid assembly.

- ou --or- rawAssembly foi compilado com uma versão posterior do Common Language Runtime do que a versão carregada atualmente.rawAssembly was compiled with a later version of the common language runtime than the version that is currently loaded.

O valor atribuído de securityContextSource não é um dos valores de enumeração.The value of securityContextSource is not one of the enumeration values.

Comentários

O assembly é carregado no domínio do aplicativo do chamador usando a origem especificada para o contexto de segurança.The assembly is loaded into the application domain of the caller using the specified source for the security context. Se rawSymbolStore for especificado, os bytes brutos que representam os símbolos para o assembly também serão carregados.If rawSymbolStore was specified, the raw bytes that represent the symbols for the assembly are also loaded.

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

Aviso

Esta API agora é obsoleta.

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido, incluindo, opcionalmente, símbolos e evidência para o 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. O assembly é carregado no domínio de aplicativo do chamador.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 http://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

Parâmetros

rawAssembly
Byte[]

Uma matriz de byte que é uma imagem baseada em COFF contendo um assembly emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Uma matriz de bytes que contém os bytes brutos que representam os símbolos do assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

securityEvidence
Evidence Evidence Evidence Evidence

Evidência para carregar o assembly.Evidence for loading the assembly.

Retornos

O assembly carregado.The loaded assembly.

Exceções

rawAssembly não é um assembly válido.rawAssembly is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e rawAssembly foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

securityEvidence não é null.securityEvidence is not null. Por padrão, a política CAS herdada não está habilitada no .NET Framework 4.NET Framework 4; quando ela não está habilitada, securityEvidence deve ser 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.

Comentários

O assembly é carregado no domínio do chamador usando a evidência fornecida.The assembly is loaded into the domain of the caller using the supplied evidence. Os bytes brutos que representam os símbolos para o assembly também são carregados.The raw bytes representing the symbols for the assembly are also loaded.

Se determinadas permissões são concedidas ou não a um assembly é algo que se baseia na evidência.Whether certain permissions are granted or not granted to an assembly is based on evidence. As regras para mesclagem de evidência de segurança e assembly são as seguintes:The rules for assembly and security evidence merging are as follows:

  • Quando você usa um Load método Evidence sem parâmetro, o assembly é carregado com a evidência que o carregador fornece.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando você usa um Load método com um Evidence parâmetro, as partes das evidências são mescladas.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Partes de evidência fornecidas como um argumento para o Load método substituem as partes das evidências fornecidas pelo carregador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando você usa uma Load sobrecarga de método com Byte[] um parâmetro para carregar uma imagem COFF, a evidência é herdada do assembly de chamada.When you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is inherited from the calling assembly. Isso se aplica ao .NET Framework versão 1,1 Service Pack 1 (SP1) e versões subsequentes.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Observação

    No .NET Framework versão 1,0 e na versão 1,1 sem SP1, quando você usa uma Load sobrecarga de método com um Byte[] parâmetro para carregar uma imagem COFF, a evidência é combinada.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. Zonee são herdados do assembly de chamada e Hash e StrongName são extraídos do assembly COFF. Site UrlZone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando você usa um Load método com um Byte[] parâmetro e Evidence para carregar uma imagem COFF, somente a evidência fornecida é usada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. A evidência do assembly de chamada e a evidência da imagem COFF são ignoradas.Evidence of the calling assembly and evidence of the COFF image are ignored.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Se você chamar o método][,<byte xref: System. Reflection. assembly. Load% 2a > mais de uma vez no mesmo assembly, mas com uma evidência diferente especificada, o Common Language Runtime não emitirá FileLoadException um porque o a igualdade e a integridade das diferentes especificações de evidência não podem ser determinadas.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. A evidência que é realizada pela primeira vez é a evidência que é usada.The evidence that first succeeds is the evidence that is used.

Observe que essa sobrecarga de método sempre cria um Assembly novo objeto com seu próprio mapeamento.Note that this method overload always creates a new Assembly object with its own mapping.

Segurança

SecurityPermission
para a capacidade de fornecer evidências.for the ability to supply evidence. Enumeração associada: ControlEvidence.Associated enumeration: ControlEvidence. Ação de segurança: Demand.Security action: Demand.

Load(String, Evidence) Load(String, Evidence) Load(String, Evidence) Load(String, Evidence)

Aviso

Esta API agora é obsoleta.

Carrega um assembly dado seu nome de exibição, carregando-o no domínio do chamador usando a evidência fornecida.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 http://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

Parâmetros

assemblyString
String String String String

O nome para exibição do assembly.The display name of the assembly.

assemblySecurity
Evidence Evidence Evidence Evidence

Evidência para carregar o assembly.Evidence for loading the assembly.

Retornos

O assembly carregado.The loaded assembly.

Exceções

assemblyString não foi encontrado.assemblyString is not found.

assemblyString não é um assembly válido.assemblyString is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyString foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Não foi possível carregar um arquivo que foi encontrado.A file that was found could not be loaded.

- ou --or-

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

Comentários

FileLoadExceptioné gerado se assemblyString especifica o nome completo do assembly, e o primeiro assembly que corresponde ao nome simples tem uma versão, cultura ou token de chave pública diferente.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. O carregador não continua a investigação de outros assemblies que correspondam ao nome simples.The loader does not continue probing for other assemblies that match the simple name.

Se determinadas permissões são concedidas ou não a um assembly é algo que se baseia na evidência.Whether certain permissions are granted or not granted to an assembly is based on evidence. As regras para mesclagem de evidência de segurança e assembly são as seguintes:The rules for assembly and security evidence merging are as follows:

  • Quando você usa um Load método Evidence sem parâmetro, o assembly é carregado com a evidência que o carregador fornece.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando você usa um Load método com um Evidence parâmetro, as partes das evidências são mescladas.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Partes de evidência fornecidas como um argumento para o Load método substituem as partes das evidências fornecidas pelo carregador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando você usa uma Load sobrecarga de método com Byte[] um parâmetro para carregar uma imagem de formato de arquivo de objeto comum (COFF), a evidência é herdada do assembly de chamada.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. Isso se aplica ao .NET Framework versão 1,1 Service Pack 1 (SP1) e versões subsequentes.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Observação

    No .NET Framework versão 1,0 e na versão 1,1 sem SP1, quando você usa uma Load sobrecarga de método com um Byte[] parâmetro para carregar uma imagem COFF, a evidência é combinada.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. Zonee são herdados do assembly de chamada e Hash e StrongName são extraídos do assembly COFF. Site UrlZone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando você usa um Load método com um Byte[] parâmetro e Evidence para carregar uma imagem COFF, somente a evidência fornecida é usada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. A evidência do assembly de chamada e a evidência da imagem COFF é ignorada.Evidence of the calling assembly and evidence of the COFF image is ignored.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Se você chamar esse método mais de uma vez no mesmo assembly, mas com uma evidência diferente especificada, o Common Language Runtime não lança um FileLoadException porque a igualdade e a integridade das diferentes especificações de evidência não podem ser determinadas.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. A evidência que é realizada pela primeira vez é a evidência que é usada.The evidence that first succeeds is the evidence that is used.

No .NET Framework versão 2.0, a arquitetura do processador é adicionada à identidade do assembly e pode ser especificada como parte das cadeias de caracteres de nome do 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. Por exemplo, "ProcessorArchitecture=msil".For example, "ProcessorArchitecture=msil". No entanto, a maneira recomendada para especificar um nome de assembly é AssemblyName criar um objeto e passá-lo para uma sobrecarga Load apropriada do método.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. Consulte AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Segurança

SecurityPermission
para carregar um assembly com evidências.to load an assembly with evidence. Enumeração associada: ControlEvidenceAssociated enumeration: ControlEvidence

Veja também

Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence)

Aviso

Esta API agora é obsoleta.

Carrega um assembly de acordo com seu AssemblyName.Loads an assembly given its AssemblyName. O assembly é carregado no domínio do chamador usando a evidência fornecida.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 http://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

Parâmetros

assemblyRef
AssemblyName AssemblyName AssemblyName AssemblyName

O objeto que descreve o assembly a ser carregado.The object that describes the assembly to be loaded.

assemblySecurity
Evidence Evidence Evidence Evidence

Evidência para carregar o assembly.Evidence for loading the assembly.

Retornos

O assembly carregado.The loaded assembly.

Exceções

assemblyRef não foi encontrado.assemblyRef is not found.

assemblyRef não é um assembly válido.assemblyRef is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyRef foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

- ou --or-

assemblyRef especifica um assembly remoto, mas a capacidade de executar código em assemblies remotos é desabilitada.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Veja <loadFromRemoteSources>.See <loadFromRemoteSources>.

Comentários

FileLoadExceptioné gerado se assemblyRef especifica o nome completo do assembly, e o primeiro assembly que corresponde ao nome simples tem uma versão, cultura ou token de chave pública diferente.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. O carregador não continua a investigação de outros assemblies que correspondam ao nome simples.The loader does not continue probing for other assemblies that match the simple name. A partir do .NET Framework 4, como a execução de código em assemblies remotos é desabilitada FileLoadException por padrão, um assemblyRef também será gerado se o especificar um 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. Para habilitar a execução de código carregado a partir de locais remotos, <loadFromRemoteSources> você pode usar o elemento de configuração.To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Observação

Não use um AssemblyName com apenas o conjunto CodeBase de propriedades.Do not use an AssemblyName with only the CodeBase property set. A CodeBase propriedade não fornece nenhum elemento da identidade do assembly (como nome ou versão), portanto, o carregamento não ocorre de acordo com as regras de carga por identidade, como você esperaria Load do método.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. Em vez disso, o assembly é carregado usando regras de carga para.Instead, the assembly is loaded using load-from rules. Para obter informações sobre as desvantagens de usar o contexto de carga, consulte a Assembly.LoadFrom sobrecarga do método ou as práticas recomendadas para o carregamento do 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 determinadas permissões são concedidas ou não a um assembly é algo que se baseia na evidência.Whether certain permissions are granted or not granted to an assembly is based on evidence. As regras para mesclagem de evidência de segurança e assembly são as seguintes:The rules for assembly and security evidence merging are as follows:

  • Quando você usa um Load método Evidence sem parâmetro, o assembly é carregado com a evidência que o carregador fornece.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando você usa um Load método com um Evidence parâmetro, as partes das evidências são mescladas.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Partes de evidência fornecidas como um argumento para o Load método substituem as partes das evidências fornecidas pelo carregador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando você usa uma Load sobrecarga de método com Byte[] um parâmetro para carregar uma imagem de formato de arquivo de objeto comum (COFF), a evidência é herdada do assembly de chamada.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. Isso se aplica ao .NET Framework versão 1,1 Service Pack 1 (SP1) e versões subsequentes.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Observação

    No .NET Framework versão 1,0 e na versão 1,1 sem SP1, quando você usa uma Load sobrecarga de método com um Byte[] parâmetro para carregar uma imagem COFF, a evidência é combinada.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. Zonee são herdados do assembly de chamada e Hash e StrongName são extraídos do assembly COFF. Site UrlZone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando você usa um Load método com um Byte[] parâmetro e Evidence para carregar uma imagem COFF, somente a evidência fornecida é usada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. A evidência do assembly de chamada e a evidência da imagem COFF é ignorada.Evidence of the calling assembly and evidence of the COFF image is ignored.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Observação

Se a AssemblyName.Name Propriedade e a AssemblyName.CodeBase Propriedade forem definidas, a primeira tentativa de carregar o assembly usará o nome de exibição (incluindo a versão, a cultura e assim por diante Assembly.FullName , conforme retornado pela propriedade).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 o arquivo não for encontrado, CodeBase será usado para pesquisar o assembly.If the file is not found, CodeBase is used to search for the assembly. Se o assembly for encontrado usando CodeBase, o nome de exibição será correspondido em relação ao assembly.If the assembly is found using CodeBase, the display name is matched against the assembly. Se a correspondência falhar, um FileLoadException será lançado.If the match fails, a FileLoadException is thrown.

Se você chamar o Load método mais de uma vez no mesmo assembly, mas com uma evidência diferente especificada, o Common Language Runtime não lança um FileLoadException porque a igualdade e a integridade das diferentes especificações de evidência não podem ser determinadas.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. A evidência que é realizada pela primeira vez é a evidência que é usada.The evidence that first succeeds is the evidence that is used.

Segurança

FileIOPermission
para acesso de leitura de um arquivo ou um diretório, e para acesso às informações no próprio caminho.for access to read from a file or directory, and for access to the information in the path itself. Enumerações associadas: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
para ler um URI que não começa com "file://".for reading a URI that does not begin with "file://".

SecurityPermission
para carregar um assembly com evidências.to load an assembly with evidence. Enumeração associada: ControlEvidenceAssociated enumeration: ControlEvidence

Veja também

Load(Byte[]) Load(Byte[]) Load(Byte[]) Load(Byte[])

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. O assembly é carregado no domínio de aplicativo do chamador.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

Parâmetros

rawAssembly
Byte[]

Uma matriz de byte que é uma imagem baseada em COFF contendo um assembly emitido.A byte array that is a COFF-based image containing an emitted assembly.

Retornos

O assembly carregado.The loaded assembly.

Exceções

rawAssembly não é um assembly válido.rawAssembly is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e rawAssembly foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Comentários

O nível de confiança de um assembly que é carregado usando esse método é o mesmo que o nível de confiança do assembly de chamada.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Para carregar um assembly de uma matriz de bytes com o nível de confiança do domínio do aplicativo, Load(Byte[], Byte[], SecurityContextSource) use a sobrecarga do método.To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Para obter mais informações sobre o uso de evidências com sobrecargas do Load método que usam matrizes de bytes, Load(Byte[], Byte[], Evidence) consulte a sobrecarga do método.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.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Observe que essa sobrecarga de método sempre cria um Assembly novo objeto com seu próprio mapeamento.Note that this method overload always creates a new Assembly object with its own mapping.

Load(String) Load(String) Load(String) Load(String)

Carrega um assembly tendo o formato longo de seu nome.Loads an assembly given the long form of its 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

Parâmetros

assemblyString
String String String String

O formato longo do nome do assembly.The long form of the assembly name.

Retornos

O assembly carregado.The loaded assembly.

Exceções

assemblyString é uma cadeia de comprimento zero.assemblyString is a zero-length string.

assemblyString não foi encontrado.assemblyString is not found.

Não foi possível carregar um arquivo que foi encontrado.A file that was found could not be loaded.

assemblyString não é um assembly válido.assemblyString is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyString foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Exemplos

O exemplo a seguir carrega um assembly de acordo com seu nome totalmente qualificado e lista todos os tipos contidos no assembly especificado.The following example loads an assembly given its fully qualified name, and lists all the types contained in the specified assembly. Para este exemplo de código ser executado, você deve fornecer o nome de assembly totalmente qualificado.For this code example to run, you must provide the fully qualified assembly name. Para obter informações sobre como obter o nome totalmente qualificado do assembly, consulte nomes de 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
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 'Class1

Comentários

A forma longa de um nome de assembly consiste em seu nome simples (como "System" para o assembly System. dll) junto com sua versão, cultura, token de chave pública e, opcionalmente, sua arquitetura de processador.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. Ele corresponde à propriedade do FullName assembly.It corresponds to the assembly's FullName property. O exemplo a seguir ilustra o uso de um nome longo para carregar o assembly System. dll para o .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é gerado se assemblyString especifica o nome completo do assembly, e o primeiro assembly que corresponde ao nome simples tem uma versão, cultura ou token de chave pública diferente.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. O carregador não continua a investigação de outros assemblies que correspondam ao nome simples.The loader does not continue probing for other assemblies that match the simple name.

Se determinadas permissões são concedidas ou não a um assembly é algo que se baseia na evidência.Whether certain permissions are granted or not granted to an assembly is based on evidence. As regras para mesclagem de evidência de segurança e assembly são as seguintes:The rules for assembly and security evidence merging are as follows:

  • Quando você usa um Load método Evidence sem parâmetro, o assembly é carregado com a evidência que o carregador fornece.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando você usa um Load método com um Evidence parâmetro, as partes das evidências são mescladas.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Partes de evidência fornecidas como um argumento para o Load método substituem as partes das evidências fornecidas pelo carregador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando você usa uma Load sobrecarga de método com Byte[] um parâmetro para carregar uma imagem de formato de arquivo de objeto comum (COFF), a evidência é herdada do assembly de chamada.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. Isso se aplica ao .NET Framework versão 1,1 Service Pack 1 (SP1) e versões subsequentes.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Observação

    No .NET Framework versão 1,0 e na versão 1,1 sem SP1, quando você usa uma Load sobrecarga de método com um Byte[] parâmetro para carregar uma imagem COFF, a evidência é combinada.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. Zonee são herdados do assembly de chamada e Hash e StrongName são extraídos do assembly COFF. Site UrlZone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando você usa um Load método com um Byte[] parâmetro e Evidence para carregar uma imagem COFF, somente a evidência fornecida é usada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. A evidência do assembly de chamada e a evidência da imagem COFF é ignorada.Evidence of the calling assembly and evidence of the COFF image is ignored.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

No .NET Framework versão 2.0, a arquitetura do processador é adicionada à identidade do assembly e pode ser especificada como parte das cadeias de caracteres de nome do 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. Por exemplo, "ProcessorArchitecture=msil".For example, "ProcessorArchitecture=msil". No entanto, a maneira recomendada para especificar um nome de assembly é AssemblyName criar um objeto e passá-lo para uma sobrecarga Load apropriada do método.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. Consulte AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Segurança

SecurityPermission
para carregar um assembly com evidências.to load an assembly with evidence. Enumeração associada: ControlEvidenceAssociated enumeration: ControlEvidence

Veja também

Load(AssemblyName) Load(AssemblyName) Load(AssemblyName) Load(AssemblyName)

Carrega um assembly de acordo com seu 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

Parâmetros

assemblyRef
AssemblyName AssemblyName AssemblyName AssemblyName

O objeto que descreve o assembly a ser carregado.The object that describes the assembly to be loaded.

Retornos

O assembly carregado.The loaded assembly.

Exceções

assemblyRef não foi encontrado.assemblyRef is not found.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

Não foi possível carregar um arquivo que foi encontrado.A file that was found could not be loaded.

- ou --or-

assemblyRef especifica um assembly remoto, mas a capacidade de executar código em assemblies remotos é desabilitada.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Veja <loadFromRemoteSources>.See <loadFromRemoteSources>.

assemblyRef não é um assembly válido.assemblyRef is not a valid assembly. - ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyRef foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Exemplos

O exemplo a seguir instancia um AssemblyName objeto e o usa para carregar o sysglobal.dll assembly.The following example instantiates an AssemblyName object and uses it to load the sysglobal.dll assembly. Em seguida, o exemplo exibe o nome completo dos tipos públicos do 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

Comentários

FileLoadExceptioné gerado se assemblyRef especifica o nome completo do assembly e o primeiro assembly que corresponde ao nome simples tem uma versão, cultura ou token de chave pública diferente.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. O carregador não continua a investigação de outros assemblies que correspondam ao nome simples.The loader does not continue probing for other assemblies that match the simple name. A partir do .NET Framework 4, como a execução de código em assemblies remotos é desabilitada FileLoadException por padrão, um assemblyRef também será gerado se o especificar um 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. Para habilitar a execução de código carregado a partir de locais remotos, <loadFromRemoteSources> você pode usar o elemento de configuração.To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Observação

Não use um AssemblyName com apenas o conjunto CodeBase de propriedades.Do not use an AssemblyName with only the CodeBase property set. A CodeBase propriedade não fornece nenhum elemento da identidade do assembly (como nome ou versão), portanto, o carregamento não ocorre de acordo com as regras de carga por identidade, como você esperaria Load do método.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. Em vez disso, o assembly é carregado usando regras de carga para.Instead, the assembly is loaded using load-from rules. Para obter informações sobre as desvantagens de usar o contexto de carga, consulte a Assembly.LoadFrom sobrecarga do método ou as práticas recomendadas para o carregamento do 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 determinadas permissões são concedidas ou não a um assembly é algo que se baseia na evidência.Whether certain permissions are granted or not granted to an assembly is based on evidence. As regras para mesclagem de evidência de segurança e assembly são as seguintes:The rules for assembly and security evidence merging are as follows:

  • Quando você usa um Load método Evidence sem parâmetro, o assembly é carregado com a evidência que o carregador fornece.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Quando você usa um Load método com um Evidence parâmetro, as partes das evidências são mescladas.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Partes de evidência fornecidas como um argumento para o Load método substituem as partes das evidências fornecidas pelo carregador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Quando você usa uma Load sobrecarga de método com Byte[] um parâmetro para carregar uma imagem de formato de arquivo de objeto comum (COFF), a evidência é herdada do assembly de chamada.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. Isso se aplica ao .NET Framework versão 1,1 Service Pack 1 (SP1) e versões subsequentes.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Observação

    No .NET Framework versão 1,0 e na versão 1,1 sem SP1, quando você usa uma Load sobrecarga de método com um Byte[] parâmetro para carregar uma imagem COFF, a evidência é combinada.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. Zonee são herdados do assembly de chamada e Hash e StrongName são extraídos do assembly COFF. Site UrlZone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Quando você usa um Load método com um Byte[] parâmetro e Evidence para carregar uma imagem COFF, somente a evidência fornecida é usada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. A evidência do assembly de chamada e a evidência da imagem COFF é ignorada.Evidence of the calling assembly and evidence of the COFF image is ignored.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Observação

Se a AssemblyName.Name Propriedade e a AssemblyName.CodeBase Propriedade forem definidas, a primeira tentativa de carregar o assembly usará o nome de exibição (incluindo a versão, a cultura e assim por diante Assembly.FullName , conforme retornado pela propriedade).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 o arquivo não for encontrado, CodeBase será usado para pesquisar o assembly.If the file is not found, CodeBase is used to search for the assembly. Se o assembly for encontrado usando CodeBase, o nome de exibição será correspondido em relação ao assembly.If the assembly is found using CodeBase, the display name is matched against the assembly. Se a correspondência falhar, um FileLoadException será lançado.If the match fails, a FileLoadException is thrown.

Segurança

FileIOPermission
para acesso de leitura de um arquivo ou um diretório, e para acesso às informações no próprio caminho.for access to read from a file or directory, and for access to the information in the path itself. Enumerações associadas: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
para ler um URI que não começa com "file://".for reading a URI that does not begin with "file://".

SecurityPermission
para carregar um assembly com evidências.to load an assembly with evidence. Enumeração associada: ControlEvidenceAssociated enumeration: ControlEvidence

Veja também

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

Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido e com a opção de incluir símbolos para o assembly.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. O assembly é carregado no domínio de aplicativo do chamador.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

Parâmetros

rawAssembly
Byte[]

Uma matriz de byte que é uma imagem baseada em COFF contendo um assembly emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Uma matriz de bytes que contém os bytes brutos que representam os símbolos do assembly.A byte array that contains the raw bytes representing the symbols for the assembly.

Retornos

O assembly carregado.The loaded assembly.

Exceções

rawAssembly não é um assembly válido.rawAssembly is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e rawAssembly foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Comentários

O nível de confiança de um assembly que é carregado usando esse método é o mesmo que o nível de confiança do assembly de chamada.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Para carregar um assembly de uma matriz de bytes com o nível de confiança do domínio do aplicativo, Load(Byte[], Byte[], SecurityContextSource) use a sobrecarga do método.To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Para obter mais informações sobre o uso de evidências com sobrecargas do Load método que usam matrizes de bytes, Load(Byte[], Byte[], Evidence) consulte a sobrecarga do método.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.

Refletir em C++ arquivos executáveis pode gerar BadImageFormatExceptionum.Reflecting on C++ executable files might throw a BadImageFormatException. Isso é provavelmente causado pelo C++ compilador que remove os endereços de realocação ou a .reloc seção do arquivo executável.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para preservar o .reloc endereço do arquivo C++ executável, especifique /fixed:no quando estiver vinculando.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Observe que essa sobrecarga de método sempre cria um Assembly novo objeto com seu próprio mapeamento.Note that this method overload always creates a new Assembly object with its own mapping.

Aplica-se a