Share via


Passo a passo: Depuração de um projeto do suplemento

Esta explicação passo a passo ilustra como criar uma simples Visual Studio o projeto de suplemento e como usar pontos de interrupção para depurar o projeto.Para obter mais informações, consulte Breakpoints and Tracepoints.

Suplementos são aplicativos compilados que usam o Visual Studio o modelo de objeto de automação para manipular ou automatizar o ambiente de desenvolvimento integrado (IDE).Para obter mais informações, consulte A criação de suplementos e assistentes.

ObservaçãoObservação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição.Esses procedimentos foram desenvolvidos com o General Development Settings ativo.Para alterar as configurações, escolha importação e Exportarconfigurações sobre o Ferramentas menu.Para obter mais informações, consulte Configurações de Visual Studio.

Para criar um simple Visual Studio suplemento do projeto

  1. Do arquivo , aponte para novae que clique em projeto.

    O New Project Dialog Box aparece.

  2. No Tipos de projeto painel, expanda Other Project Typese selecione extensibilidade.

  3. No painel Templates, selecione - in Visual Studio.

  4. No nome de campo, digite SimpleAddIn como o nome do seu projeto de suplemento.Clique em OK.

    O Add-in Wizard é iniciado.

  5. No Bem-vindo ao Assistente de suplemento página, clique em próximo.

  6. No Select a Programming Language página, clique em **criar um Add-in usando Visual C#**e, em seguida, clique em próximo.

  7. No Selecionar um Host do aplicativo , aceite as opções padrão e, em próximo.

  8. No Insira um nome e descrição de página, digite o Add-in Simple como o nome para o add-in e digite usado para ilustrar como depurar um suplemento simple. como uma descrição para seu suplemento.Clique em Next.

  9. Sobre o suplemento escolha as opções de de página, marque a opção, Sim, criar um item de menu 'Ferramentas'. Aceite os padrões restantes.Clique em Next.

  10. No escolhendo ' Ajuda sobre ' informações página, selecione o Yes, I would like my Add-in para oferecer 'Sobre' caixa de informações. opção e, em seguida, clique em próximo.

  11. Sobre o Resumo página, clique em Concluir.

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

  12. Em Solution Explorer, com o botão direito do referências nó e selecione Add Reference para adicionar uma referência ao seu assembly.

    Isso permite o uso dos tipos na System.Windows.Forms espaço para nome.

    O Add Reference Dialog Box aparece.

  13. No .NET da sala, clique duas vezes no componente, System.

    Em Solution Explorer, uma referência para o System.Windows.Forms espaço para nome é exibido sob o referências nó.

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

  14. Em Connect. cs, adicione a seguinte instrução na parte superior da SimpleAddIn o escopo para permitir o uso mais fácil de um MessageBox objeto:

    using System.Windows.Forms;
    
  15. Adicionar um MessageBox o objeto para seu suplemento, adicionandoMessageBox.Show("Debugging a Simple Add-in");para o Exec método em Connect. CS:

    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. Clique no Salvar tudo o botão para salvar seu trabalho.

Para depurar seu projeto de suplemento de Visual Studio

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

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

    Um red dot (ou ponto de interrupção) é exibido e o texto nessa linha é realçado em vermelho.

  2. Do Debug menu, clique em Start Debugging.

    Sua atual Visual Studio sessão — a sessão do depurador — perderá o foco e o programa que está sendo depurado, será aberto em outra instância do Visual Studio.

  3. Da Visual Studio IDE que está sendo depurado, clique no Ferramentas menu.

    SimpleAddIn está listado na parte superior dos itens de menu.

  4. Selecione o SimpleAddIn comando para executar seu suplemento.

    Isso leva você para a linha onde você pode definir o ponto de interrupção na Visual Studio o depurador de sessão, que é realçado em amarelo.

  5. Do Debug menu na sessão do depurador, selecione Step Into.

    O foco alterna de volta para o programa depurado.Abre a caixa de mensagem, indicando que o add-in foi executado.

  6. Clique em OK para fechar a caixa de mensagem.

  7. Na sessão do depurador, selecione continuar partir do Debug menu.

    O depurado Visual Studio sessão recupera o foco.

  8. Sair do depurado Visual Studio sessão.

  9. Em Connect. cs, clique no ponto de interrupção que você definiu ao lado do MessageBox instrução para removê-lo do seu código-fonte.

    Como você pode ver, quando você depura um add-in, outra instância da Visual Studio IDE abre para hospedar o suplemento em execução.A primeira instância exibe seu código e lhe permite depurar, como definir variáveis de inspeção, pontos de interrupção e assim por diante.Quando tiver terminado de depuração, a segunda instância do IDE fecha e retorna para código do add-in na primeira instância.

Consulte também

Outros recursos

A criação de suplementos e assistentes

Automação e extensibilidade referência