Depuração no nível do documento projetos

Você pode depurar projetos de nível de documento para Microsoft Office o Word e Excel de Microsoft Office usando as mesmas ferramentas de Visual Studio, que você pode usar para outros projetos. Quando você executar o projeto no modo de depuração, Visual Studio inicia o Word ou Excel e o depurador se anexa a tudo o que está sendo executado no mesmo processo com o Word ou Excel. Para obter mais informações sobre o Visual Studio de ferramentas de depuração, consulte Depuração no Visual Studio.

Dica

Feche todas as instâncias do Word ou Excel antes de criar e depurar para evitar conflitos.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para os seguintes aplicativos: Excel 2007 e Excel 2010; Word 2007 e Word 2010. 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?.

F10 e o comportamento de F11

Quando você inicia a depuração de um projeto do Office, F10 e F11 não têm o mesmo comportamento quando você inicia a depuração de outros projetos de Visual Basic ou C#. Em projetos de Visual Basic ou C#, o depurador pára na função principal; projetos do Office, Visual Studio não tem controle sobre a função principal do aplicativo do Office. No entanto, durante a depuração, F10 e F11 têm as mesmas funções como em projetos de Visual Basic e C#. For more information, see Debugging Shortcut Keys, Brief Scheme.

Interrupção do depurador

Quando você inicia a depuração de um documento ou pasta de trabalho, abre o documento ou pasta de trabalho em um novo processo do Word ou Excel. Quando você pára o depurador, o depurador encerra o processo do Word ou Excel abruptamente ou desconecta se você tiver o depurador definido para desanexar. Todos os outros documentos ou pastas de trabalho abertas em um processo do Word ou Excel é encerrado também ser fechadas sem aviso e quaisquer alterações não salvas serão perdidas. Isso pode incluir todos os documentos ou pastas de trabalho abertas durante a execução do depurador.

Normalmente, é melhor desanexar do processo antes de interromper o depurador para que você pode encerrar o Word e Excel da maneira normal. É possível também desanexar do processo primeiro se você trabalhar em uma planilha ou documento aberto após a interrupção do depurador. Para obter mais informações sobre desanexar do processo, consulte Como: Desconectar todos os processos.

Durante as sessões de depuração pesado, repetidamente interromper o depurador e fazendo com que o Word fechar repentinamente podem levar no modelo Normal corrompidos. Se isso acontecer, você pode excluir o modelo Normal danificado e ele será recriado automaticamente na próxima vez que abrir o Word. No entanto, as macros que foram armazenadas no modelo Normal não serão recriadas.

Apesar de bloqueios no modelo Normal do Word aberto no Visual Studio

Quando o Word é aberto no Visual Studio, ele bloqueia o modelo padrão Normal. Quando você executa sua solução para depuração, uma cópia do Word é aberta em outro processo. Se você fizer as personalizações em nível de aplicativo à cópia aberta do Word, é possível salvar as alterações porque o modelo Normal está bloqueado pelo processo que está aberto dentro de Visual Studio.

Em tempo de execução, o Word abre instâncias separadas de documentos em um único processo, portanto, não é mais provável que um documento aberto irá bloquear o modelo Normal e impedir alterações de nível de aplicativo.

Para obter mais informações, consulte o artigo da Base de Conhecimento "PRB: Avisar para salvar normal. dot quando usando o Word como um servidor de automação" (https://support.microsoft.com/default.aspx?scid=kb;en-us;285885).

Conjuntos de dados em cache de depuração.

Sempre que você criar um projeto, o dataset é esvaziado e recriado. Se você deseja depurar um dataset em cache, você deve abrir o documento fora do Visual Studio e, em seguida, anexar o depurador.

Depuração de projetos de documento do Word com base em documento do Word 97-2003 (*. doc) formato

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

Controle de origem

Depurar propriedades não são compartilhadas entre vários usuários sob controle de origem. Projetos de Visual Basic e C# armazenam propriedades de depuração em um arquivo específico do usuário (<ProjectName>. vbproj.user ou <ProjectName>. csproj.user), e este arquivo não está sob controle de origem. Se a depuração de mais de uma pessoa, cada pessoa deve inserir manualmente as propriedades de depuração.

Command Line Arguments

Se o Start Action na Debug página de propriedade é definida como Iniciar o projeto, Visual Studio não usa argumentos de linha de comando quando a depuração do projeto, mesmo se você especificou argumentos de linha de comando como opções de inicialização. Se você quiser usar os argumentos de linha de comando quando você inicia a depuração, você deve selecionar um Start Action diferente de Iniciar o projeto.

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 documento ou pasta de trabalho que está associada com a personalização, ou, se isso falhar, no local % TEMP % pasta. O nome do arquivo de log é nome do documento.extensão. log, como, por exemplo, ExcelWorkbook1.xlsx.log. Para parar o erros de log, excluir a variável de ambiente ou defini-la como 0 (zero).

Consulte também

Tarefas

Como: Manipular erros em projetos do Office

Conceitos

Visão Geral do Processo de Compilação de uma Solução Office

Outros recursos

Depuração no Visual Studio

Implantar soluções do Office

Projetando e criando soluções do Office

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

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.