AssemblyLoadContext.LoadFromAssemblyName(AssemblyName) Método

Definição

Resolve e carrega um assembly dado seu AssemblyName.Resolves and loads an assembly given its AssemblyName.

public:
 System::Reflection::Assembly ^ LoadFromAssemblyName(System::Reflection::AssemblyName ^ assemblyName);
public System.Reflection.Assembly LoadFromAssemblyName (System.Reflection.AssemblyName assemblyName);
member this.LoadFromAssemblyName : System.Reflection.AssemblyName -> System.Reflection.Assembly
Public Function LoadFromAssemblyName (assemblyName As AssemblyName) As Assembly

Parâmetros

assemblyName
AssemblyName

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

Retornos

O assembly carregado ou gera algo.The loaded assembly, or throws.

Exceções

assemblyName é null.assemblyName is null.

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

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

Foi carregado um assembly ou módulo que não correspondeu ao assemblyName.An assembly or module was loaded which did not match the assemblyName.

Comentários

LoadFromAssemblyName carrega um assembly resolvendo o AssemblyName.LoadFromAssemblyName loads an assembly by resolving the AssemblyName. Isso dispara uma resolução completa.This triggers a full resolution. A sequência de fallback de resolução segue este processo:The resolution fallback sequence follows this process:

  1. O método chama Load(AssemblyName).The method calls Load(AssemblyName).

    Importante

    Load(AssemblyName) não deve chamar esse método para evitar o estouro de pilha recursivo.Load(AssemblyName) must not call this method to prevent recursive stack overflow.

  2. A menos que o assembly seja carregado ou uma exceção seja lançada, o método tentará carregar o assembly no AssemblyLoadContextpadrão.Unless the assembly is loaded or an exception is thrown, the method attempts to load the assembly in the default AssemblyLoadContext.

  3. A menos que o assembly seja carregado ou uma exceção seja gerada, o método acionará o evento Resolving.Unless the assembly is loaded or an exception is thrown, the method fires the Resolving event.

  4. A menos que o assembly seja carregado ou uma exceção seja gerada, o método acionará o evento AssemblyResolve.Unless the assembly is loaded or an exception is thrown, the method fires the AssemblyResolve event.

Observação

FileLoadException será gerada se assemblyRef especificar o nome completo do assembly e o primeiro assembly que corresponde ao nome simples tiver uma versão ou cultura incompatível.FileLoadException is thrown if assemblyRef specifies the full assembly name, and the first assembly that matches the simple name has a incompatible version or culture. 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.

Cada AssemblyLoadContext só pode carregar:Each AssemblyLoadContext can load only:

  • Uma versão de um assembly executável.One version of an executable assembly.
  • Uma versão de um assembly satélite para cada cultura.One version of a satellite assembly for each culture.

Aplica-se a