Como adicionar referências a namespaces de automação

Artigo
06/10/2015

Em Visual Studio 2013, suplementos são preteridos. Recomendamos que você atualize seus suplementos para as extensões VSPackage. Para obter mais informações sobre como atualizar, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Quando você adiciona uma referência a EnvDTE, a EnvDTE80, a EnvDTE90, ou a EnvDTE100, você tem a opção de usar um assembly .NET ou uma versão da biblioteca COM. O que você deve escolher depende do seu projeto.

Se você estiver mantendo um aplicativo ou suplemento mais antigo, talvez precise usar a versão COM de EnvDTE, de EnvDTE80, de EnvDTE90 ou de EnvDTE100. Se você estiver criando um novo aplicativo ou suplemento gerenciado, entretanto, provavelmente vai querer usar a versão da matriz .NET.

Quando você usa o Assistente de Suplemento para criar um suplemento em qualquer linguagem de programação ou quando cria uma macro, o processo adiciona referências ao EnvDTE, a assemblies EnvDTE90, Env90, e Env100, e o arquivo que contém a classe Conectar adiciona diretivas de using (em Visual Basic, em imports) para o EnvDTE e para namespaces EnvDTE80.

Para acessar os objetos de automação fora de macros ou suplementos criados com o Assistente de Suplemento, no entanto, você deve adicionar manualmente referências de assembly e políticas using (no Visual Basic, imports). Quando você adiciona uma referência de assembly manualmente, você também deve definir a propriedade de Inserir Tipos Interop do assembly a false. Para fazer isso, siga estas etapas:

Adicione a referência de assembly. No Gerenciador de Soluções, abra o menu de atalho do projeto, selecione Adicionar, Referências e, em seguida, clique no botão Adicionar Nova Referência. Na guia .NET, selecione o assembly e, em seguida, clique no botão OK. Em um projeto C#, você verá o nome do assembly sob o nó Referências em Gerenciador de Soluções. Em um projeto do Visual Basic, você verá o nome do assembly nas propriedades do projeto. Clique com o botão direito do mouse no Gerenciador de Soluções, e selecione Propriedades. As páginas de propriedades serão exibidas. Selecione a página Referências no painel esquerdo.
Selecione a referência de assembly e, na janela Propriedades, defina a propriedade Inserir Tipos Interop do assembly para false.

Após adicionar referências aos namespaces, você provavelmente desejará programar com os objetos de DTE e de DTE2. Para obter mais informações, consulte Como obter referências para os objetos DTE e DTE2.

Dica

Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Para adicionar referências manualmente aos namespaces EnvDTE no Visual Basic ou Visual C#

No Gerenciador de Soluções, abra o menu de atalho do projeto, selecione Adicionar, Referências e, em seguida, clique no botão Adicionar Nova Referência.
Na caixa de diálogo Adicionar Referência, na guia para o tipo de componente desejado — por exemplo, .NET ou COM — selecione EnvDTE, selecione EnvDTE80, EnvDTE90 e EnvDTE100.
Escolha o botão OK adicionar as duas novas referências ao projeto.
Para ativar o Intellisense para os novos assemblies no editor de códigos, na parte superior do módulo ou classe do projeto, adicione um dos seguintes:
```
Imports EnvDTE
Imports EnvDTE80
Imports EnvDTE90
Imports EnvDTE100
```
```
using EnvDTE;
using EnvDTE80;
using EnvDTE90;
using EnvDTE100;
```

Para adicionar referências manualmente aos namespaces EnvDTE no Managed Visual C++

No Gerenciador de Soluções, abra o menu de atalho do projeto, selecione Adicionar, Referências e, em seguida, clique no botão Adicionar Nova Referência.
Na guia .Net, selecione EnvDTE, EnvDTE80, e EnvDTE90 e clique no botão Adicionar.
Escolha OK adicionar as novas referências ao projeto.
Para ativar o IntelliSense para os novos assemblies no editor de códigos, na parte superior do arquivo de projeto principal, adicione o seguinte:
```
// Visual C++
#using <envdte.dll>
#using <envdte80.dll>
#using <envdte90.dll>
#using <envdte100.dll>
```

Para adicionar referências a EnvDTE e namespaces EnvDTE80 para o Visual C++ não gerenciado (ATL)

Em um cabeçalho ou arquivo de origem apropriado, adicione o seguinte:

#pragma warning( disable : 4278 )
#pragma warning( disable : 4146 )
//The following #import imports EnvDTE based on its LIBID.
#import "libid:80cc9f66-e7d8-4ddd-85b6-d9e6cd0e93e2" version("8.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE80 based on its LIBID.
#import "libid:1A31287A-4D7D-413e-8E32-3B374931BD89" version("8.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE90 based on its LIBID.
#import "libid: 2ce2370e-d744-4936-a090-3fffe667b0e1" version("9.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE100 based on its LIBID.
#import "libid: 26ad1324-4b7c-44bc-84f8-b86aed45729f" version("10.0") 
lcid("0") raw_interfaces_only named_guids
#pragma warning( default : 4146 )
#pragma warning( default : 4278 )

Consulte também

Partilhar via

Como adicionar referências a namespaces de automação

Para adicionar referências manualmente aos namespaces EnvDTE no Visual Basic ou Visual C#

Para adicionar referências manualmente aos namespaces EnvDTE no Managed Visual C++

Para adicionar referências a EnvDTE e namespaces EnvDTE80 para o Visual C++ não gerenciado (ATL)

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais