Como: instalar um assembly no cache de assembly globalHow to: Install an assembly into the global assembly cache

O cache de assembly global armazena os assemblies que vários aplicativos compartilham.The global assembly cache (GAC) stores assemblies that several applications share. Instale um assembly no cache de assembly global com um dos seguintes componentes:Install an assembly into the global assembly cache with one of the following components:

Importante

Você pode instalar apenas assemblies de nome forte no cache de assembly global.You can install only strong-named assemblies into the GAC. Para obter informações de como criar um assembly de nome forte, confira Como: assinar um assembly com um nome forte.For information about how to create a strong-named assembly, see How to: Sign an assembly with a strong name.

Windows InstallerWindows Installer

Windows Installer, o mecanismo de instalação do Windows, é a maneira recomendada de adicionar assemblies ao cache de assembly global.Windows Installer, the Windows installation engine, is the recommended way to add assemblies to the global assembly cache. O Windows Installer fornece uma contagem de referências de assemblies no cache de assembly global e outros benefícios.Windows Installer provides reference counting of assemblies in the global assembly cache and other benefits. Para criar um pacote do instalador do Windows Installer, use a extensão de conjunto de ferramentas WiX do Visual Studio 2017.To create an installer package for Windows Installer, use the WiX toolset extension for Visual Studio 2017.

Ferramenta de Cache de Assembly GlobalGlobal assembly cache tool

Você pode usar a ferramenta de cache de assembly global (gacutil.exe) para adicionar assemblies ao cache de assembly global e para exibir o conteúdo do cache de assembly global.You can use the global assembly cache tool (gacutil.exe) to add assemblies to the global assembly cache and to view the contents of the global assembly cache.

Observação

O gacutil.exe é indicado apenas para fins de desenvolvimento.Gacutil.exe is for development purposes only. Não o use para instalar assemblies de produção no cache de assembly global.Don't use it to install production assemblies into the global assembly cache.

A sintaxe para usar o gacutil.exe para instalar um assembly no cache de assembly global é a seguinte:The syntax for using gacutil.exe to install an assembly in the GAC is as follows:

gacutil -i <assembly name>

Nesse comando, <assembly name> é o nome do assembly a ser instalado no cache de assembly global.In this command, <assembly name> is the name of the assembly to install in the global assembly cache.

Se gacutil.exe não estiver no caminho do sistema, use o Prompt de Comando do Desenvolvedor para VS <versão>.If gacutil.exe isn't in your system path, use the Developer Command Prompt for VS <version>.

O exemplo a seguir instala um assembly com o nome do arquivo hello.dll no cache de assembly global.The following example installs an assembly with the file name hello.dll into the global assembly cache.

gacutil -i hello.dll

Observação

Nas versões anteriores do .NET Framework, a extensão do shell do Windows Shfusion.dll permitia a instalação de assemblies arrastando-os no Explorador de Arquivos.In earlier versions of the .NET Framework, the Shfusion.dll Windows shell extension let you install assemblies by dragging them to File Explorer. Começando no .NET Framework 4, a Shfusion.dll ficou obsoleta.Beginning with .NET Framework 4, Shfusion.dll is obsolete.

Consulte tambémSee also