Instruções passo a passo: depurando um projeto de suplemento

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.

Essa explicação passo a passo mostra como criar um projeto básico do suplemento Visual Studio e como usar pontos de interrupção para depurá-los. Para obter mais informações, consulte Breakpoints and Tracepoints.

Os suplementos são aplicativos criados usando o modelo de objeto de automação do Visual Studio para manipular ou automatizar o ambiente de desenvolvimento integrado (IDE). Para obter mais informações, consulte Criando suplementos e assistentes.

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 criar um projeto básico de Suplemento do Visual Studio

1. Na barra de menu, escolha Arquivo, Novo, Projeto.

   O New Project Dialog Box aparece.

2. No painel Tipos de Projeto, expanda Outros Tipos de Projeto e então selecione Extensibilidade.

3. Na lista Modelos, selecione Suplemento do Visual Studio.

4. No campo Nome, digite SimpleAddIn. Escolha o botão OK.

   O Add-in Wizard é iniciado.

5. Na página Bem vindo ao Assistente de Suplemento, escolha o botão Avançar.

6. Na página Selecionar uma Linguagem de Programação, selecione Criar Suplemento usando o Visual C# e escolha Avançar.

7. Na página Selecionar um Aplicativo Host, aceite as opções padrão e escolha Avançar.

8. Na página Digite um nome e uma descrição, digite Simple Add-in (suplemento simples) como nome e Used (usado) para ilustrar como depurar um suplemento simples, conforme a descrição. Escolha Avançar.

9. Na página Escolha as opções de suplemento, selecione a opção Sim, crie um item de menu "Ferramentas", aceite as opções restantes e, em seguida, clique em Avançar.

10. Na página Escolhendo as informações de "Ajuda Sobre", selecione a opção de Sim, eu gostaria que meu suplemento oferecesse informações na caixa "Sobre" e, em seguida, clique em Avançar.

11. Na página Sumário, clique no botão Finalizar.

    O Assistente de Suplemento gera seu novo projeto de suplemento e abre o arquivo Connect.cs. Esta é a classe principal que contém o código para o suplemento.

12. No Gerenciador de Soluções, no menu de atalho do projeto, selecione Adicionar, Referências e, em seguida, clique no botão Adicionar Nova Referência.

    Isso permite o uso de tipos no namespace System.Windows.Forms.

    A caixa de diálogo Add Reference é exibida.

13. Na guia .Net, selecione System.Windows.Forms.dll e clique no botão OK.

    No Gerenciador de Soluções, uma referência ao namespace System.Windows.Forms é exibida sob o nó Referências.

    Este namespace contém o código que é necessário para exibir uma Caixa de Mensagem, que é usada no exemplo de código a seguir.

14. Em Connect.cs, adicione a seguinte declaração próxima à parte superior do escopo de SimpleAddIn para permitir um uso mais fácil de um objeto MessageBox:

    using System.Windows.Forms;
    

15. Adicionar um objeto de MessageBox ao suplemento adicionando MessageBox.Show("Debugging a Simple Add-in"); o método de Exec :

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    

16. Escolha o botão Salvar tudo para salvar seu trabalho.

Para depurar seu projeto de suplementos do Visual Studio

1. Em Connect.cs, clique na margem esquerda pela instrução:

   MessageBox.Show("Debugging a Simple Add-in")
   

   Um ponto vermelho (que simboliza um ponto de interrupção) é exibido, e o texto nesta linha é realçado em vermelho.

2. Na barra de menus, escolha Depurar, Iniciar Depuração.

   O depurador atual da sessão - Visual Studio, da sessão de depuração, perderá o foco e o programa que está sendo depurado abrirá em outra instância de Visual Studio.

3. Na barra de menus na versão de depuração do Visual Studio, escolha Ferramentas, SimpleAddIn para executar o suplemento.

   Isso o levará ao ponto de interrupção definido.

4. Na barra de menus, na versão de depuração, escolha Depurar, Depuração Completa.

   O foco volta para o programa depurado. A caixa de mensagem abre, e indica que o suplemento foi executado.

5. Escolha o botão OK para fechar a caixa de mensagem.

6. Na barra de menus, na versão de depuração, escolha Depurar, Continuar.

   Feche a instância de depuração do Visual Studio.

7. Em Connect.cs, remova o ponto de interrupção ao lado da instrução MessageBox.

Consulte também

Outros recursos

Criando suplementos e assistentes

Referência sobre automação e extensibilidade