Componentes de um Adicionar-no projeto
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 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 implementada, 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 termina o carregamento. |
|
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 Assistente Add-in 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 método é certamente mais importantes usados em projetos do 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. O OnConnection método é passado quatro parâmetros: Application, ConnectMode, AddInInst, and custom. Applicationrepresenta o Visual Studio IDE. Ele é convertido 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 em 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 na qual você pode opcionalmente passar dados para o add-in.
Além de para essas variáveis de inicialização OnConnection também contém código para criar um comando para o suplemento na Ferramentas menu se você 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á vazia por padrão. Para lidar com o suplemento eventos relacionados, você pode usar esses outros métodos para respondê-las. Por exemplo, você pode adicionar código para o OnAddInsUpdate método para enviar uma mensagem de notificação para outro procedimento, quando um suplemento é fechado. Você pode chamar OnBeginShutdown executar a limpeza de tarefas quando o Visual Studio IDE está sendo desligado para baixo.
Quando você cria um add-in e verifique o "você gostaria de criar um comando de interface de barra para seu suplemento?" opção (que cria um comando para o suplemento sobre o Ferramentas menu), o IDTCommandTarget interface é implementada. Dois métodos adicionais — QueryStatus e Exec — são adicionados ao projeto do 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 sobre o Ferramentas menu, então isso é onde você deve adicionar código para responder ao evento.