Compartilhar via


Gerenciado de chaves de localização do arquivo VSPackage

Visual Studiodeve ser capaz de localizar o assembly DLL para carregar o VSPackage. Você pode localizá-lo de várias maneiras, conforme descrito na tabela a seguir.

Método

Descrição

Use a chave de registro da Base de código.

A chave da Base de código pode ser usada para direcionar Visual Studio para carregar o assembly VSPackage de qualquer caminho de arquivo totalmente qualificado. O valor da chave deve ser o caminho do arquivo para a DLL. Esta é a melhor maneira de ter Visual Studio carregar o assembly do pacote. Essa técnica é às vezes conhecida como a "técnica de diretório de instalação de CodeBase/particular". Durante o registro o valor do codebase é passado para as classes de atributo de registro por meio de uma instância de RegistrationContext tipo.

Coloque a dll é Carregada para o PrivateAssemblies directory.

Coloque o assembly na PrivateAssemblies subdiretório da Visual Studio directory. Assemblies localizados em PrivateAssemblies são detectados automaticamente, mas não são visíveis no Add References caixa de diálogo. A diferença entre PrivateAssemblies e PublicAssemblies é que os assemblies no PublicAssemblies são enumerados na Add References caixa de diálogo. Se você optou por não usar a técnica de "diretório de instalação do CodeBase/private", então você deve instalar na PrivateAssemblies directory.

Use um assembly de nome forte e a chave de registro do Assembly.

A chave do Assembly pode ser usada para direcionar explicitamente Visual Studio carregar um forte chamado VSPackage assembly. O valor da chave deve ser o nome forte do assembly.

Coloque a dll é Carregada para o PublicAssemblies directory.

Finalmente, o assembly também pode ser colocado na PublicAssemblies subdiretório. Assemblies localizados em PublicAssemblies são detectadas automaticamente e aparecerá também na Add References caixa de diálogo na Visual Studio.

VSPackage módulos (assemblies) só deve ser colocado na PublicAssemblies diretório se elas contiverem gerenciados componentes que se destinam a ser reutilizado por outros desenvolvedores VSPackage. A maioria dos assemblies não atendem esse critério.

Dica

Use assemblies assinados, fortes para todos os assemblies dependentes.Esses assemblies também devem ser instalados em seu próprio diretório ou o cache global de assemblies (GAC).Isso protege contra conflitos com assemblies que têm o mesmo nome de arquivo de base, conhecido como vinculação de nome fraco.

Consulte também

Conceitos

Carregando VSPackages

Outros recursos

VSPackages gerenciados

Managed VSPackage Registration Keys

Registrando VSPackages