Partilhar via


Como: Instalar um assembly no cache de assembly global

Nota

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

O cache de assembly global (GAC) armazena assemblies que vários aplicativos compartilham. Instale um assembly no cache de assembly global com um dos seguintes componentes:

Importante

Você pode instalar somente assemblies de nome forte no cache de assembly global. Para obter informações sobre como criar um assembly de nome forte, consulte Como assinar um assembly com um nome forte.

Windows Installer

O Windows Installer, o mecanismo de instalação do Windows, é a maneira recomendada de adicionar assemblies ao cache global de assemblies. O Windows Installer fornece contagem de referência de assemblies no cache de assembly global e outros benefícios. Para criar um pacote de instalação para o Windows Installer, use a extensão do conjunto de ferramentas do WiX para o Visual Studio 2017.

Ferramenta Global Assembly Cache

Você pode usar o utilitário .NET Global Assembly Cache (gacutil.exe) para adicionar assemblies ao cache de assembly global e exibir o conteúdo do cache de assembly global.

Nota

Gacutil.exe é apenas para fins de desenvolvimento. Não o use para instalar assemblies de produção no cache de assembly global.

A sintaxe para usar gacutil.exe para instalar um assembly no GAC é a seguinte:

gacutil -i <assembly name>

Neste comando, <assembly name> é o nome do assembly a ser instalado no cache global de assembly.

Se gacutil.exe não estiver no caminho do sistema, use o Visual Studio Developer Command Prompt ou o Visual Studio Developer PowerShell.

O exemplo a seguir instala um assembly com o nome de arquivo hello.dll no cache de assembly global.

gacutil -i hello.dll

Nota

Em versões anteriores do .NET Framework, a extensão de shell do Shfusion.dll Windows permite instalar assemblies arrastando-os para o Explorador de Arquivos. A partir do .NET Framework 4, Shfusion.dll está obsoleto.

Consulte também