Compartilhar via


Trabalhando com assemblies e o cache de assemblies global

Observação

Este artigo é específico para aplicativos .NET Framework. Não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

Se você pretender compartilhar um assembly com vários aplicativos, será necessário instalá-lo no cache de assembly global. Cada computador em que o Common Language Runtime está instalado tem um cache de código em todo o computador. O cache de assembly global armazena assemblies projetados especificamente para serem compartilhados por vários aplicativos no computador. Um assembly deve ter um nome forte para ser instalado no cache de assembly global.

Observação

Assemblies colocados no cache de assembly global devem ter o mesmo nome de assembly e de arquivo (não incluindo a extensão de nome de arquivo). Por exemplo, um assembly com o nome de myAssembly deve ter um nome de arquivo de myAssembly.exe ou myAssembly.dll.

Você deve compartilhar assemblies instalando-os no cache de assembly global somente quando necessário. Como diretriz geral, mantenha as dependências de um assembly particulares e localize os assemblies no diretório de aplicativo, a menos que o compartilhamento de um assembly seja explicitamente obrigatório. Além disso, você não precisa instalar assemblies no cache de assembly global a fim de torná-los acessíveis para interoperabilidade COM ou código não gerenciado.

Há diversas razões para instalar um assembly no cache de assembly global:

  • Local compartilhado.

    Assemblies que devem ser usados por aplicativos podem ser colocados no cache de assembly global. Por exemplo, se todos os aplicativos devem usar um assembly localizado no cache de assembly global, uma declaração de política de versão pode adicionada ao arquivo Machine.config que redireciona referências para o assembly.

  • Segurança do arquivo.

    Os administradores geralmente protegem o diretório systemroot usando uma ACL (Lista de Controle de Acesso) para controlar os acesso de gravação e de execução. Como o cache de assembly global é instalado em um diretório do systemroot, ele herda a ACL desse diretório. É recomendável que apenas usuários com privilégios Administrador tenham permissão para excluir arquivos do cache de assembly global.

  • Controle de versão lado a lado.

    Várias cópias de assemblies com o mesmo nome, mas com informações diferentes de versão, podem ser mantidas no cache de assembly global.

  • Local adicional de pesquisa.

    O Common Language Runtime verifica o cache de assembly global para um assembly que corresponde à solicitação de assembly antes de investigar ou usar as informações da base de código em um arquivo de configuração.

Observe que há situações em que explicitamente não é recomendado instalar um assembly no cache de assembly global. Se colocar um dos assemblies que compõem um aplicativo no cache de assembly global, você não poderá mais replicar nem instalar o aplicativo usando XCOPY para copiar o diretório do aplicativo. Nesse caso, você também deve mover o assembly para o cache de assembly global.

Nesta seção

Como: Instalar um Assembly no Cache de Assembly Global Descreve as maneiras de instalar um assembly no cache de assembly global.

Como: Exibir o Conteúdo do Cache de Assembly Global Explica como usar o Gacutil.exe (Ferramenta de Cache de Assembly Global) para exibir o conteúdo do cache de assembly global.

Como: Remover um Assembly do Cache de Assembly Global Explica como usar o Gacutil.exe (Ferramenta de Cache de Assembly Global) para remover um assembly do cache de assembly global.

Usar Componentes Atendidos com o Cache de Assembly Global Explica por que os componentes atendidos (componentes COM+ gerenciados) devem ser colocados no cache de assembly global.

Criar Assemblies Fornece uma visão geral da criação de assemblies.

Cache de Assembly Global Descreve o cache de assembly global.

Como: Exibir o Conteúdo do Assembly Explica como usar o Ildasm.exe (Desmontador do IL) para exibir informações comuns de linguagem intermediária (CIL) em um assembly.

Como o Runtime Localiza os Assemblies Descreve como o runtime de linguagem comum localiza e carrega os assemblies que compõem seu aplicativo.

Programação com Assemblies Descreve os assemblies e os blocos de construção dos aplicativos gerenciados.