AssemblyLoadContext.LoadFromAssemblyName(AssemblyName) Método

Definição

Namespace:

System.Runtime.Loader

Assembly:

System.Runtime.Loader.dll

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.

Confira também

• Algoritmo de carregamento de assembly gerenciado