Compartilhar via


Walkthrough: Depuração um Adicionar-no projeto

Esta explicação passo a passo ilustra como criar uma simples Visual Studio o projeto de suplemento e como usar os 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 Criação de assistentes e ins Adicionar-.

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 Exportar configurações sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

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 , digite SimpleAddIn como o nome do seu projeto de suplemento. Clique em OK.

    O Welcome to the Add-In Wizard, Visual Studio 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 suplemento usando Visual C#**e, em seguida, clique em próximo.

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

  8. No Digite um nome e descrição de página, digite Add-in Simple, como o nome para seu suplemento 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 'Ferramentas' item de menu. Aceite os padrões restantes. Clique em Next.

  10. No escolhendo 'Ajuda sobre' Informações página, selecione o Sim, eu gostaria que meu suplemento oferecem 'Sobre' informações de caixa. 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 Adicionar referência de para adicionar uma referência ao seu assembly.

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

    O Add Reference Dialog Box aparece.

  13. No .NET guia, 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 o add-in, adicionandoMessageBox.Show("Debugging a Simple Add-in");para o Exec método 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 o Salvar tudo o botão para salvar seu trabalho.

Para depurar seu projeto 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 no Visual Studio sessão do depurador, 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 da sessão.

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

    Como você pode ver, quando você depurar um suplemento, outra instância da Visual Studio IDE se abre para hospedar executando add-in. 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

Criação de assistentes e ins Adicionar-

Automation and Extensibility Reference