AssemblyLoadContext.LoadFromAssemblyName(AssemblyName) Método

  • Referência

Definição

Namespace:
System.Runtime.Loader
Assembly:
System.Runtime.Loader.dll
Origem:
AssemblyLoadContext.cs
Origem:
AssemblyLoadContext.cs
Origem:
AssemblyLoadContext.cs

Resolve e carrega um assembly dado seu 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.

Retornos

Assembly

O assembly carregado ou gera algo.

Exceções

ArgumentNullException

assemblyName é null.

FileNotFoundException

assemblyName não foi encontrado.

BadImageFormatException

assemblyName não é um assembly válido.

FileLoadException

Foi carregado um assembly ou módulo que não correspondeu ao assemblyName.

Comentários

LoadFromAssemblyName carrega um assembly resolvendo o AssemblyName. Isso dispara uma resolução completa. A sequência de fallback de resolução segue este processo:

  1. O método chama Load(AssemblyName).

    Importante

    Load(AssemblyName) não deve chamar esse método para evitar o estouro de pilha recursivo.

  2. A menos que o assembly seja carregado ou uma exceção seja gerada, o método tenta carregar o assembly no padrão AssemblyLoadContext.

  3. A menos que o assembly seja carregado ou uma exceção seja gerada, o método aciona o Resolving evento.

  4. A menos que o assembly seja carregado ou uma exceção seja gerada, o método aciona o AssemblyResolve evento.

Observação

FileLoadException será gerado 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. O carregador não continua investigando outros assemblies que correspondam ao nome simples.

Cada AssemblyLoadContext um pode carregar apenas:

  • Uma versão de um assembly executável.
  • Uma versão de um assembly satélite para cada cultura.

Aplica-se a

Confira também