Compartilhar via


Depurando em projetos de nível de aplicativo

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de documento

Versão do Microsoft Office

  • Microsoft Office Sistema de 2007

  • Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode depurar projetos de nível de aplicativo usando as mesmas ferramentas de Visual Studio Microsoft que você usar para outros projetos de Visual Studio.Visual Studio recursos do depurador, tais como a capacidade de inserir pontos de interrupção e exibir as variáveis na janela locais, também estão disponíveis quando você depurar projetos de nível de aplicativo.Para obter mais informações sobre Visual Studio ferramentas de Depurando, consulte Depuração no Visual Studio.Para obter mais informações sobre projetos de nível de aplicativo, consulte Arquitetura de nível de aplicativo Adicionar-ins.

Iniciando e parando o depurador

Você pode iniciar a Depurando um projeto de nível de aplicativo exatamente como iniciar a Depurando de outros projetos de Visual Studio; Por exemplo, você pode pressionar a tecla F5.Quando você inicia a Depurando do projeto, um novo processo para o aplicativo do Office-alvo é iniciado e o Adicionar - in é carregado.Quando você interromper o depurador, o depurador encerra o processo de aplicativo abruptamente ou desconecta se você tiver o depurador definido para desanexar.For more information, see Teclas de atalho, esquema gerais de Depurando.

Exibir exceções

Se um Adicionar - in criado utilizando Ferramentas do Visual Studio para o Office gerar uma exceção, o aplicativo do Microsoft Office continua sem exibir a exceção.Definir o depurador para Interrupçãor em Tudo as exceções se você desejar ver quando Adicionar - em exceções são lançadas.For more information, see Como: Manipular erros em projetos do Office.

Você também pode inserir instruções Try...Catch ao redor de código que pode gerar uma exceção.Para obter mais informações sobre como usar Try...Catch instruções, consulte Como: Testar o código com um Bloquear try … catch no Visual Basic e Como: Manipular uma exceção com try/catch (C# Programming Guide).

Depurando Desativado Adicionar-ins

Aplicativos do Microsoft Office podem desativar Adicionar-ins que se comportam inesperadamente quando estão sendo carregados.Um aplicativo do Microsoft Office desativa Adicionar-ins para evitar que códigos problemáticos sejam carregados toda vez que o aplicativo for iniciado.No entanto, também é fácil causar um comportamento inesperado durante a Depurando típico.Para obter informações sobre como reativar o Adicionar-ins, consulte Como: Reativar um Adicionar - em que foi foi desativado.

Há dois tipos de desabilitar que aplicativos do Microsoft Office usar para Adicionar-ins: desativar disco rígido e desativando disco.

Desativar disco rígido

Desativar disco rígido ocorre quando o código executado quando o Adicionar - in está causas carregadas ao aplicativo fechar inesperadamente, ou quando você interrompe o depurador enquanto o construtor ou o manipulador de eventos Startup está em execução.

Se um aplicativo do Microsoft Office 2003 rígido desativa um suplemento criado usando Ferramentas do Visual Studio para o Office, desabilita a aplicativo Ambos o suplemento e AddinLoader.dll.AddinLoader.dll é usado para carregar os suplementos criados usando Ferramentas do Visual Studio para o Office.Como resultado, Tudo Adicionar-ins criados usando Ferramentas do Visual Studio para o Office para esse aplicativo do Microsoft Office são impedidos de Carregando para o usuário atual.Para obter mais informações sobre AddinLoader.dll, consulte Arquitetura de nível de aplicativo Adicionar-ins.

Se um aplicativo de sistema do Microsoft Office 2007 rígido desativa um suplemento criado usando Ferramentas do Visual Studio para o Office, o aplicativo desativa apenas o Adicionar-in que causou a falha.Como resultado, outros Adicionar-ins criados usando Ferramentas do Visual Studio para o Office para esse aplicativo do Office 2007 continuará a carregar.

Desativando disco

Desativando disco ocorre quando um Adicionar-in lança uma Exceção sem Tratamento no construtor ou o manipulador de eventos Startup e o aplicativo Microsoft Office não não inesperadamente Fechar.O aplicativo pode Desativar somente atual Adicionar - in seja carregado para o usuário atual.Quando um disco de aplicativo desativa um Adicionar-in, ele define o valor da entrada do Registro LoadBehavior para o suplemento para 2.A entrada LoadBehavior está localizada na seguinte chave do Registro: HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\ < Nome do aplicativo> < de nome do suplemento > \Addins\.Para obter mais informações sobre essa chave do Registro, consulte Entradas de registro para Application-Nível Adicionar-ins.

Solução de problemas Adicionar - ins usando um arquivo de log e mensagens de erro

O Tempo de execução Ferramentas do Visual Studio para o Office pode gravar Tudo erros que ocorrem durante a inicialização em um arquivo de log ou exibir cada erro em uma caixa de mensagem.Por padrão, essas opções estão desativadas.Você pode ativar as opções ao criar variáveis de ambiente.

Para exibir cada erro em uma caixa de mensagem, Criar 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 Configuração para 1 (um).

Gravar os erros em um arquivo de log, criar uma variável de ambiente denominada VSTO_LOGALERTS e defina-o como 1 (um).O Tempo de execução Ferramentas do Visual Studio para o Office cria o arquivo de log na pasta que contém o manifesto do aplicativo.O nome padrão é < Manifestname >. manifest.log.Para interromper o log de erros, Excluir a variável de ambiente ou defina-o como 0 (zero).

Consulte também

Tarefas

Como: Reativar um Adicionar - em que foi foi desativado

Como: Manipular erros em projetos do Office

Conceitos

Programação Application-Nível Adicionar-ins

Outros recursos

Criando e Depurando Office Solutions