Referenciando assemblies de automação e o objeto DTE2

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Para criar aplicativos de automação, você deve executar etapas para ganhar acesso aos membros de automação. Primeiro, você deve referenciar os assemblies de automação necessárias, e segundo, você deve obter uma referência para o objeto de nível superior, DTE2.

Em versões anteriores do Visual Studio, todos os itens de automação principais ficavam localizados em um assembly denominado EnvDTE, e seu objeto mais alto hierarquicamente era o objeto de DTE. É o objeto pai de todos os objetos de automação central, coleções, e seus membros. DTE2 deriva de DTE.

Em versões posteriores do Visual Studio, as adições e atualizações foram feitas em alguns desses objetos, coleções, e membros. Em vez de atualizar o assembly existente e comprometer a compatibilidade retroativa para suplementos e projetos de automação existentes, todas as funcionalidades novas atualizadas ficam em assemblies chamados EnvDTE80 (EnvDTE versão 8.0), EnvDTE90 (EnvDTE versão 9.0) e EnvDTE100 (EnvDTE versão 10.0). A maioria das funções atualizadas em [N:EnvDTE80,] EnvDTE90, e EnvDTE100 mantêm os mesmos nomes que as versões anteriores mas anexam um número ao final do nome da função. Por exemplo, a versão mais recente da coleção de TaskItems é chamada TaskItems2, e a versão mais recente do objeto de Solution é chamada Solution2. Como os novos membros são mais resistentes que as versões anteriores e contêm funcionalidade mais recente, a abordagem recomendada é usar novos objetos e coleções para gravar novos aplicativos de automação.

Embora os novos itens estejam em EnvDTE80, EnvDTE90 e EnvDTE100, a maior parte da funcionalidade de automação principal ainda está em EnvDTE. Portanto, ao escrever novos aplicativos de automação (como suplementos), referencie EnvDTE, EnvDTE80, EnvDTE90 e EnvDTE100. Você pode fazer isso em uma etapa, referenciando as bibliotecas COM "Microsoft Development Environment 8.0", "Microsoft Development Environment 9.0", "Microsoft Development Environment 9.0A" e "Microsoft Development Environment 10.0". Além disso, se você usar membros do assembly de EnvDTE, também será necessário definir uma referência aos objetos DTE e DTE2. Isso fornece acesso a todos os itens.

Para obter informações sobre como obter acesso aos modelos de objeto específicos de projeto, consulte Grupos de automação funcionais.

Nesta seção

• Como adicionar referências a namespaces de automação
  Demonstra como adicionar referências para os namespaces apropriados.

• Erro quando EnvDTE é usado com assemblies VSLangProj
  Descreve um possível erro que você pode receber quando um projeto usa o assembly EnvDTE e um ou mais dos assemblies VSLangProj.

• Como obter referências para os objetos DTE e DTE2
  Demonstra como obter referências para os objetos apropriados.

• Anexando a instâncias específicas do IDE
  Fornece informações sobre como fazer referência a uma instância específica do ambiente de desenvolvimento integrado (IDE).

Seções relacionadas

• Gráfico do modelo de objetos automation
  Fornece um mapa gráfico a todos os componentes compartilhados do modelo de objeto de automação.

• Criando suplementos e assistentes
  Fornece informações básicas sobre a criação de suplementos e assistentes no Visual Studio.