System.Runtime.Loader.AssemblyLoadContext classe

Este artigo fornece observações complementares à documentação de referência para esta API.

O AssemblyLoadContext representa um contexto de carga. Conceitualmente, um contexto de carga cria um escopo para carregar, resolver e potencialmente descarregar um conjunto de assemblies.

O AssemblyLoadContext existe principalmente para fornecer isolamento de carregamento de montagem. Ele permite que várias versões do mesmo assembly sejam carregadas dentro de um único processo. Ele substitui os mecanismos de isolamento fornecidos por várias AppDomain instâncias no .NET Framework.

Nota

• AssemblyLoadContext não fornece quaisquer elementos de segurança. Todo o código tem permissões totais do processo.
• Somente no .NET Core 2.0 - 2.2, AssemblyLoadContext é uma classe abstrata. Para criar uma classe concreta nessas versões, implemente o AssemblyLoadContext.Load(AssemblyName) método.

Uso no tempo de execução

O tempo de execução implementa dois contextos de carga de assembly:

• AssemblyLoadContext.Default representa o contexto padrão do tempo de execução, que é usado para o assembly principal do aplicativo e suas dependências estáticas.
• O Assembly.LoadFile(String) método isola os assemblies que carrega instanciando o arquivo AssemblyLoadContext. Ele tem um esquema de isolamento simplista que carrega cada assembly em seu próprio AssemblyLoadContext sem resolução de dependência.

Uso do aplicativo

Um aplicativo pode criar seu próprio AssemblyLoadContext para criar uma solução personalizada para cenários avançados. A personalização centra-se na definição de mecanismos de resolução de dependências.

O AssemblyLoadContext fornece dois pontos de extensão para implementar a resolução de assembly gerenciado:

1. O AssemblyLoadContext.Load(AssemblyName) método fornece a primeira chance para o resolver, carregar e retornar o AssemblyLoadContext assembly. Se o método retornar null, o carregador tentará carregar o AssemblyLoadContext.Load(AssemblyName) conjunto no AssemblyLoadContext.Default.
2. Se o não conseguir resolver a montagem, o AssemblyLoadContext.Default original AssemblyLoadContext terá uma segunda chance de resolver a montagem. O tempo de execução gera o Resolving evento.

Além disso, o método virtual permite a AssemblyLoadContext.LoadUnmanagedDll(String) personalização da resolução de assembly não gerenciado padrão. A implementação padrão retorna null, o que faz com que a pesquisa em tempo de execução use sua política de pesquisa padrão. A política de pesquisa padrão é suficiente para a maioria dos cenários.

Desafios técnicos

• Não é possível carregar várias versões do tempo de execução em um único processo.

  Atenção

  Carregar várias cópias ou versões diferentes de assemblies de estrutura pode levar a um comportamento inesperado e difícil de diagnosticar.

  Sugestão

  Use limites de processo com comunicação remota ou entre processos para resolver esse problema de isolamento.

• O tempo de carregamento da montagem pode dificultar o teste e a depuração. Normalmente, os assemblies são carregados sem que suas dependências sejam resolvidas imediatamente. As dependências são carregadas conforme necessário:

  • Quando o código se ramifica em um assembly dependente.
  • Quando o código carrega recursos.
  • Quando o código carrega explicitamente assemblies.

• A implementação de AssemblyLoadContext.Load(AssemblyName) pode adicionar novas dependências que podem precisar ser isoladas para permitir que diferentes versões existam. A implementação mais natural colocaria essas dependências no contexto padrão. Um design cuidadoso pode isolar as novas dependências.

• O mesmo assembly é carregado várias vezes em contextos diferentes.

  • Isso pode levar a mensagens de erro confusas, por exemplo, "Não é possível transmitir objeto do tipo 'Sample.Plugin' para digitar 'Sample.Plugin'".
  • O marshaling através dos limites de isolamento não é trivial. Uma solução típica é usar uma interface definida em um assembly que só é carregado no contexto de carga padrão.