Componentes de um projeto de suplemento
Suplemento projetos são projetos de biblioteca de classes que são criados usando o Assistente de suplemento e que são compilados nas DLLs.Suplemento projetos contêm um arquivo de código-fonte chamado conectar-se, também é o nome da classe.A classe conectar implementa uma interface denominada IDTExtensibility2 comandos que passam entre o suplemento e o Visual Studio ambiente de desenvolvimento integrado (IDE).
IDTExtensibility2 tem cinco métodos que, quando implementada, atuar sistema autônomo eventos.
Método |
Descrição |
|---|---|
Esse método é chamado quando o suplemento é carregado no Visual Studio. |
|
Esse método é chamado quando Visual Studio conclusão do carregamento. |
|
Esse método é chamado quando um suplemento carrega ou descarrega de Visual Studio. |
|
Esse método é chamado quando Visual Studio está fechado. |
|
Esse método é chamado quando o suplemento é descarregado da Visual Studio. |
Juntamente com o IDTExtensibility2 interface, o IDTCommandTarget interface é implementada automaticamente se você marcar a opção de interface do usuário ao usar o Assistente de suplemento para criar um suplemento.Se você optar por criar ou manipular barras de comandos no seu suplemento, você também deve implementar o namespace Microsoft.VisualStudio.CommandBars.
Método OnConnection
The OnConnection definitivamente, é o método mais importantes usada em projetos de suplemento porque ele é chamado sempre que um suplemento é carregado. Além disso, é usada para telefonar Outros código de automação no suplemento.The OnConnection método é passado quatro parâmetros: Application, ConnectMode, AddInInst, e custom. Application representa a Visual Studio IDE. Ele é um conversão sistema autônomo um DTE2 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 forma em que o suplemento seja carregado; isto é, por meio da linha de comando por abrindo uma solução, e assim por diante. AddInInst representa o suplemento propriamente dito. The custom parâmetro é uma matriz em que opcionalmente você pode passar dados para o suplemento.
Juntamente com a inicialização dessas variáveis, 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 de suplemento.
Outros métodos suplemento
Os outros quatro suplemento métodos, que são colocados no local pelo Assistente de suplemento, estão vazios por padrão.Para lidar com suplemento eventos relacionados, você pode usar esses outros métodos para responder a elas.Por exemplo, você poderia adicionar código à OnAddInsUpdate método para enviar uma mensagem de notificação para outro procedimento quando um suplemento é fechado. Você pode chamar OnBeginShutdown para executar a limpeza de tarefas quando o Visual Studio IDE está sendo desligado.
Quando você cria um suplemento e verifique o "você gostaria de criar um comando de BAR da interface do usuário para seu suplemento?" opção (que cria um comando para o suplemento noFerramentas menu), the IDTCommandTarget interface é implementada. Dois métodos adicionais — QueryStatus e Exec — são adicionados ao suplemento projeto para lidar com as tarefas de comando. Esses métodos contêm uma pequena quantidade de código para ajudar a incluir o comando sobre o Ferramentas menu e responder a cliques de um usuário.QueryStatus notifica o suplemento de disponibilidade do comando. The Exec método é chamado quando um usuário clica comando do suplemento sobre o Ferramentas menu, portanto, isso é onde você deve adicionar código para responder a esse evento.