Componentes de um projeto do suplemento
Add-in de projetos são projetos de biblioteca de classes que são criados usando o o Assistente de suplemento e que são compilados em DLLs.Suplemento projetos contêm um arquivo de código-fonte chamado conectar-se, também é o nome da classe.A classe de conectar-se implementa uma interface denominada IDTExtensibility2 que passa os comandos entre o add-in e o Visual Studio o ambiente de desenvolvimento integrado (IDE).
IDTExtensibility2tem cinco métodos que, quando implementadas, atuar como eventos.
Método |
Descrição |
|---|---|
Este método é chamado quando o suplemento é carregado no Visual Studio. |
|
Esse método é chamado quando Visual Studio terminar de carregar. |
|
Este método é chamado quando um suplemento carrega ou descarrega de Visual Studio. |
|
Esse método é chamado quando Visual Studio está fechado. |
|
Este método é chamado quando o suplemento é descarregado do Visual Studio. |
Além de IDTExtensibility2 interface, o IDTCommandTarget interface é implementada automaticamente se você marcar a opção de interface do usuário ao usar o Add-in Wizard para criar um suplemento.Se você optar por criar ou manipular as barras de comando no seu suplemento, você também deve implementar o namespace Microsoft.VisualStudio.CommandBars.
Método OnConnection
O OnConnection é, sem dúvida, o mais importante método usado em projetos de suplemento porque ele é chamado sempre que um suplemento é carregado.Além disso, ele é usado para chamar outro código de automação do add-in.The OnConnection method is passed four parameters: Application, ConnectMode, AddInInst, and custom.Applicationrepresenta o Visual Studio IDE.Ele é um conversão como um DTE2 o objeto com o nome, _applicationObject.Este objeto representa o principal objeto no modelo de automação do núcleo e fornece acesso a todos os seus tipos e membros.ConnectMode(cujos valores estão contidos no Extensibility.extConnectMode) representa a maneira na qual o suplemento está sendo carregado; Isto é, por meio da linha de comando, por abrir uma solução, e assim por diante.AddInInstrepresenta o próprio suplemento.O custom parâmetro é uma matriz, opcionalmente, na qual você pode passar dados para o suplemento.
Para além de Inicializando essas variáveis, OnConnection também contém o código para criar um comando para o suplemento na Ferramentas menu se tiver selecionado essa opção ao criá-la com o Assistente Add-in.
Outros métodos de suplemento
Os outros quatro suplemento métodos, que são colocados em prática pela Assistente Add-in, estão vazios por padrão.Para lidar com o suplemento eventos relacionados, você pode usar esses outros métodos para respondê-los.Por exemplo, você pode adicionar código para o OnAddInsUpdate método para enviar uma mensagem de notificação para outro procedimento, quando um add-in é fechado.Você pode chamar OnBeginShutdown executar a limpeza de tarefas quando o Visual Studio IDE está sendo desligado.
Quando você cria um add-in e verifique o "você gostaria de criar um comando de UI da barra para seu suplemento?" opção (que cria um comando para o suplemento na Ferramentas menu), o IDTCommandTarget interface é implementada.Dois métodos adicionais — QueryStatus e Exec — são adicionados ao projeto de suplemento para lidar com as tarefas de comando.Esses métodos contêm uma pequena quantidade de código para ajudar a colocar o comando na Ferramentas menu e responder a cliques de um usuário.QueryStatusnotifica o add-in de disponibilidade do comando.O Exec método é chamado quando um usuário clica comando do add-in na Ferramentas menu, então isso é onde você deve adicionar código para responder a esse evento.