Depuração de projetos de nível de aplicativo

Você pode depurar projetos de nível de aplicativo usando o mesmo Microsoft Visual Studio ferramentas podem ser usadas para outros Visual Studio projetos. Visual Studiorecursos, como, por exemplo, a capacidade de inserir pontos de interrupção e exibir variáveis do depurador do Locals janela, também estão disponíveis quando você depurar projetos de nível de aplicativo. Para obter mais informações sobre Visual Studio a depuração de ferramentas, consulte Depuração no Visual Studio. Para obter mais informações sobre projetos de nível de aplicativo, consulte Arquitetura dos suplementos de nível de aplicativo.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para uma demonstração de vídeo relacionada, consulte Fazer como i: Depurar um aplicativo do VSTO?.

Iniciando e parando o depurador

Você pode iniciar a depuração de um projeto de nível de aplicativo como iniciar a depuração de outros Visual Studio projetos; Por exemplo, você pode pressionar a tecla F5. Quando você inicia a depuração de seu projeto, um novo processo de aplicativo do Office-alvo é iniciado e o suplemento é carregado. Quando você pára o depurador, o depurador encerra o processo de aplicativo abruptamente ou desconecta se você tiver o depurador definido para desanexar. For more information, see Debugging Shortcut Keys, Brief Scheme.

Exibir exceções

Se um suplemento criado usando ferramentas de desenvolvimento do Office em Visual Studio lança uma exceção, o aplicativo Microsoft Office continua sem exibir a exceção. Defina o depurador para quebrar em todas as exceções, se você deseja ver quando o suplemento exceções são lançadas. For more information, see Como: Manipular erros em projetos do Office.

Você também pode inserir Try...Catch instruções de código que pode lançar uma exceção. Para obter mais informações sobre como usar Try...Catch instruções, consulte Como: Código de teste com um bloco Try …Bloco catch no Visual Basic e How to: Handle an Exception Using try/catch (C# Programming Guide).

Depuração desativada Add-ins

Aplicativos de Microsoft Office podem desativar os suplementos que se comportam de forma inesperada. Um aplicativo de Microsoft Office desativa o add-ins para impedir que o código problemático carregando toda vez que o aplicativo for iniciado. No entanto, também é fácil causar um comportamento inesperado durante a depuração típico. Para obter informações sobre como habilitar novamente o add-ins, consulte Como: Reativar um suplemento que tenha sido desativado.

Há dois tipos de desativação que Microsoft Office que os aplicativos usam para suplementos: desativando o disco rígido e desativando suave.

Desativar disco rígido

Desativando o disco rígido pode ocorrer quando um add-in faz com que o aplicativo seja encerrado inesperadamente. Também pode ocorrer em seu computador de desenvolvimento se você interromper o depurador enquanto o Startup o manipulador de eventos no seu suplemento estiver em execução. Quando um add-in é desativado de disco rígido, ela aparece na Itens desativados a lista no aplicativo.

Se um disco rígido de aplicativo do Office desativa um suplemento criado usando ferramentas de desenvolvimento do Office em Visual Studio, o aplicativo desativa apenas o suplemento que causou a falha. Outros suplementos criados usando ferramentas de desenvolvimento do Office em Visual Studio para o aplicativo do Office continuarão a carregar.

Desabilitando suave

Desabilitando soft pode ocorrer quando um add-in produz um erro que não cause ao aplicativo fechar inesperadamente. Por exemplo, um aplicativo pode soft desativar um suplemento se ele lança uma exceção não tratada durante a Startup manipulador de eventos está em execução. Quando um add-in é desativado suave, ela aparece na suplementos de aplicativo inativos a lista no aplicativo e o aplicativo altera o valor da LoadBehavior entrada do registro para o suplemento indicar que é descarregado. Para obter mais informações sobre o LoadBehavior a entrada do registro, consulte Entradas de registro de suplementos em nível de aplicativo.

Solucionando problemas de erros de instalação usando o Visualizador de eventos

O Visual Studio Tools for Office runtime grava as mensagens para o Visualizador de eventos do Windows para todas as exceções que são lançados ao instalar ou desinstalar o Office solutions. Você pode usar essas mensagens para solucionar problemas de implantação e de instalação. For more information, see Log de eventos para soluções do Office.

Solucionando problemas de erros de inicialização usando um arquivo de Log e mensagens de erro

O Visual Studio Tools for Office runtime pode gravar todos os erros que ocorrem durante a inicialização para um arquivo de log ou exibem cada erro em uma caixa de mensagem. Por padrão, essas opções estão desativadas. Você pode ativar as opções Criando variáveis de ambiente.

Para exibir cada erro em uma caixa de mensagem, crie uma variável de ambiente denominada VSTO_SUPPRESSDISPLAYALERTS e defini-la como 0 (zero). Você pode suprimir as mensagens, excluindo a variável de ambiente ou defini-la como 1 (um).

Para gravar um arquivo de log de erros, crie uma variável de ambiente denominada VSTO_LOGALERTS e defina-o como 1 (um). O Visual Studio Tools for Office runtime cria o arquivo de log na pasta que contém o manifesto de implantação para o suplemento, ou, se isso falhar, no local % TEMP % pasta. O nome padrão é nome do suplemento. vsto.log. Para parar o erros de log, excluir a variável de ambiente ou defini-la como 0 (zero).

Consulte também

Tarefas

Como: Reativar um suplemento que tenha sido desativado

Como: Manipular erros em projetos do Office

Outros recursos

Criação e depuração de soluções do Office

Os suplementos de nível de aplicativo de programação.

Histórico de alterações

Date	History	Motivo
Setembro de 2010	Foi adicionada a secção sobre como solucionar problemas de erros de instalação usando o Visualizador de eventos.	Aprimoramento de informações.
Maio de 2010	Corrigido alguns detalhes sobre o log de erros.	Correção de bug de conteúdo.