Partilhar via


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

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:

  1. 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.

  2. 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#

  1. 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.

  2. 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.

  3. Escolha o botão OK adicionar as duas novas referências ao projeto.

  4. 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++

  1. 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.

  2. Na guia .Net, selecione EnvDTE, EnvDTE80, e EnvDTE90 e clique no botão Adicionar.

  3. Escolha OK adicionar as novas referências ao projeto.

  4. 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

Tarefas

Como controlar suplementos usando o Gerenciador de Suplementos

Instruções passo a passo: criando um assistente

Conceitos

Registro de suplementos

Gráfico do modelo de objetos automation

Outros recursos

Criando suplementos e assistentes