Depuração de projetos do Office

Você pode depurar projetos do Office usando as mesmas ferramentas do Microsoft Visual Studio você usa para outros projetos de Visual Studio .os recursos do depurador deVisual Studio , como a capacidade de inserir pontos de interrupção e variáveis da janela de Locais , também estão disponíveis quando você depura projetos do Office.Para obter mais informações sobre ferramentas de depuração de Visual Studio , consulte Depuração no Visual Studio.

Dica
Para simplificar a depuração, feche instâncias abertas de aplicativo do Office antes do compila e depure.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Para uma demonstração de vídeo relacionada, consulte Como: eu faço depurar um aplicativo de VSTO?.

Iniciando e parar o depurador

Você pode iniciar a depuração de um projeto do Office exatamente como você iniciar depuração outros projetos de Visual Studio ; por exemplo, você pode pressionar a tecla F5.Quando você começar a criar um projeto do suplemento ao aplicativo, um novo processo para o aplicativo de destino do Office é iniciado e o suplemento é carregado.Quando você começar a criar um projeto de um documento nível, documento ou pasta de trabalho abre em um novo processo do word ou Excel.

Quando você para o depurador, o depurador finaliza o processo do aplicativo ou abruptamente, separe-o se você tiver definido o depurador para desanexar.Todos outros documentos que estão abertos no processo do aplicativo é encerrado do Office são fechados também sem aviso, e quaisquer alterações não exceto são perdidos.Isso pode incluir todos os documentos ou pastas de trabalho que estão abertos quando o depurador executar.

Normalmente, é melhor desanexar do processo antes de interromper o depurador, para que você possa interromper o aplicativo do Office a forma normal.Você também pode desanexar do processo primeiro se você ainda deseja trabalhar com um documento aberto ou uma planilha após ter parado o depurador.Para obter mais informações sobre desanexar do processo, consulte Como: desanexar todos os processos.

Se você está depurando uma personalização da nível para palavras, parando repetidamente o depurador e a palavra fazer com que o fechamento de repente podem levar ao modelo normal que se torna corrompido.Se isso acontecer, você pode excluir o modelo normal e corrompido será recriado automaticamente da próxima vez que você abrir palavra.Em o entanto, nenhum macros que foram armazenados no modelo normal não são recriados.

F10 e comportamento de F11

Quando você começar a criar um projeto do Office, F10 e F11 não têm o mesmo comportamento que quando você iniciar depuração outros projetos do Visual Basic ou C#.Em projetos Visual Basic ou C#, as paradas do depurador na função de chave; em projetos do Office, o Visual Studio não tem controle sobre a função do aplicativo principal do Office.Em o entanto, durante a depuração, F10 e F11 têm as mesmas funções que em projetos Visual Basic e C#.

exibindo exceções

Por causa da maneira que o código gerenciado interage com código não gerenciado, o Visual Studio não exibe os erros que são lançados por aplicativos do Microsoft Office.Por exemplo, se um suplemento criados usando ferramentas de desenvolvimento do Office em Visual Studio gera uma exceção, o aplicativo do Microsoft Office continue sem exibir um erro.Para consultar esses erros, defina o depurador para quebrar em exceções do common language runtime.Para obter mais informações, consulte Como: Interromper quando uma exceção é lançada..

Se você definir o depurador para quebrar em exceções do common language runtime, todas as exceções interromperá agora o depurador, incluindo que você tratou e algumas exceções de tempo de execução próprias de primeira tentativa, que não pode ser relevante para seu projeto.Os erros que se referem ao msosec que não ser encontrado aparecem em cada projeto, mas são seguras de ignorar.Essas exceções de msosec não afetará a solução.

Você também pode usar instruções de Try...Catch redor de seus métodos para capturar exceções.

Por padrão, o Visual Studio também não exibe erros de depuração just-in-time para projetos do Office; no entanto, você pode ativar esse recurso para que você possa ver erros que são gerados.Para obter mais informações, consulte Depuração Just-In-Time.

Argumentos da linha de comando

Se Iniciar ação na página de propriedades de Depurar é definido como Iniciar projeto, o Visual Studio não usar argumentos de linha de comando para depurar o projeto, mesmo se você especificar argumentos de linha de comando como opções.Se você desejar usar argumentos de linha de comando quando você iniciar a depuração, você deve selecionar Iniciar ação a não ser Iniciar projeto.

Controle de Código-fonte

As propriedades de depuração não são compartilhados entre vários usuários sob controle de origem.Os projetos Visual Basic e C# armazenam as propriedades de depuração em um arquivo específico de usuário (ProjectName.vbproj.user ou ProjectName.csproj.user), e esse arquivo não está sob controle de origem.Se mais de uma pessoa está depurando, cada pessoa deve entrar em propriedades de depuração manualmente.

Depurando conjunto de dados armazenados em cache em um projeto de um documento Nível

Cada vez que você cria um projeto, o conjunto de dados é esvaziado e recriado.Se você quiser depurar um dataset em cache, você deve abrir o documento fora do Visual Studio e então anexe o depurador.

Depurando os projetos do documento do word com base no formato de documento do word 97-2003 (*.doc)

Para depurar um projeto do documento do word com base no formato de documento do word 97-2003 (*.doc), você deve adicionar a pasta de projeto à lista de confiança da pasta.Para obter mais informações sobre como fazer isso, consulte. Concedendo confiança aos documentos.

Suplementos desativado depuração

Os aplicativos do Microsoft Office podem desativar suplementos que se comportam inesperado.Um aplicativo do Microsoft Office desativa adendos para evitar todas as vezes o código problemático de carregamento que o aplicativo é iniciado.Em o entanto, também é fácil causar um comportamento inesperado durante a depuração típica.Para obter informações sobre como reabilitar suplementos, consulte Como: reativar um suplemento que tenha sido desativado.

Há dois tipos de desativar o uso de aplicativos do Microsoft Office para suplementos: duramente desativando e desativar de delicado.

Duramente desativando

Desativar difícil pode ocorrer quando um suplemento faz com que o aplicativo fecha inesperado.Também pode ocorrer no seu computador de desenvolvimento se você para o depurador quando o manipulador de eventos de Startup no suplemento executar.Quando um suplemento é desativado difícil, aparecerá na lista de Itens Desabilitados no aplicativo.

Se um aplicativo do Office desativa duramente um suplemento criados usando ferramentas de desenvolvimento do Office no Visual Studio, o aplicativo desativa somente o suplemento que causou a falha.O outro suplementos criado usando ferramentas de desenvolvimento do Office no Visual Studio para o aplicativo do Office continuará a carregar.

Desativar virtual

Desativar virtual pode ocorrer quando um suplemento gera um erro que não cause o aplicativo fecha inesperado.Por exemplo, um aplicativo pode desativar suave um suplemento se encontra uma exceção não tratada quando o manipulador de eventos de Startup executar.Quando um suplemento é desativado virtual, aparecerá na lista de Suplementos de Aplicativo Inativos o aplicativo, e o aplicativo altera o valor da entrada de Registro de LoadBehavior para que o suplemento indica que é descarregado.Para obter mais informações sobre entrada de Registro de LoadBehavior , consulte Entradas de registro de suplementos em nível de aplicativo.

Erros de instalação de solução de problemas usando o visualizador de eventos

Visual Studio Tools for Office Runtime escrever mensagens ao visualizador de eventos no windows para todas as exceções que são geradas quando você instala ou desinstala soluções do Office.Você pode usar essas mensagens para resolver problemas de instalação e implantação.

Erros de inicialização de solução de problemas usando um arquivo de log e mensagens de erro

Visual Studio Tools for Office Runtime pode escrever os erros que ocorrem durante a inicialização em um arquivo de log ou exibem cada erro em uma caixa de mensagem.Por padrão, essas opções estão desativadas.Você pode girar as opções sobre como criar variáveis de ambiente.

Para exibir cada erro em uma caixa de mensagem, crie uma variável de ambiente chamado VSTO_SUPPRESSDISPLAYALERTS e defina como 0 (zero).Você pode eliminar as mensagens excluindo a variável de ambiente ou definindo o a um (1).

Para gravar os erros em um arquivo de log, crie uma variável de ambiente chamado VSTO_LOGALERTS e defina como 1 (um).Visual Studio Tools for Office Runtime cria o arquivo de log na pasta que contém o manifesto de implantação do suplemento, ou a pasta que contém o documento ou pasta de trabalho que estão associados com personalização.Se isso falhar, Visual Studio Tools for Office Runtime cria o arquivo de log na pasta local %TEMP%.Para suplementos do aplicativo, o nome padrão é nome do suplemento.vsto.log.Para projetos de um documento nível, o nome do arquivo de log é nome do documento.extensão.log, como ExcelWorkbook1.xlsx.log.Para parar de registrar erros, exclua a variável de ambiente ou defina como 0 (zero).

Consulte também

Tarefas

Como: reativar um suplemento que tenha sido desativado

Outros recursos

Construindo soluções do Office

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