Depurar projetos do Office
Você pode depurar projetos do Office usando as mesmas ferramentas do Microsoft Visual Studio que você usa para outros projetos do Visual Studio. Os recursos do depurador do Visual Studio, como a capacidade de inserir pontos de interrupção e exibir variáveis na janela Locais, também estão disponíveis quando você depura projetos do Office. Para obter mais informações sobre ferramentas de depuração do Visual Studio, consulte Depurar no Visual Studio.
Dica
Para simplificar a depuração, feche todas as instâncias abertas do aplicativo do Office antes de criá-lo e depurá-lo.
Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO. Consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.
Observação
Interessado em desenvolver soluções que estendam a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os Suplementos do Office têm um espaço pequeno em comparação com os suplementos e soluções VSTO, e você pode criá-los usando praticamente qualquer tecnologia de programação da Web, como HTML5, JavaScript, CSS3 e XML.
Iniciar e parar o depurador
Você pode começar a depurar um projeto do Office da mesma forma que começa a depurar outros projetos do Visual Studio; por exemplo, você pode pressionar a tecla F5 . Quando você começa a depurar um projeto de suplemento VSTO, um novo processo para o aplicativo do Office de destino é iniciado e o suplemento VSTO é carregado.
Quando você começa a depurar um projeto de nível de documento, o documento ou pasta de trabalho é aberto em um novo processo do Word ou Excel.
Quando você interrompe o depurador, o depurador encerra o processo do aplicativo abruptamente ou desanexa se você tiver o depurador definido para desanexar. Todos os outros documentos abertos no processo de aplicativo do Office encerrado também são fechados sem aviso e todas as alterações não salvas são perdidas. Isso pode incluir todos os documentos ou pastas de trabalho que são abertos enquanto o depurador está em execução.
Normalmente, é melhor desanexar do processo antes de parar o depurador, para que você possa sair do aplicativo do Office da maneira normal. Você também pode desanexar do processo primeiro se ainda quiser trabalhar com um documento ou planilha aberta depois de parar o depurador.
Se você estiver depurando uma personalização em nível de documento para o Word, parar repetidamente o depurador e fazer com que o Word feche repentinamente pode levar ao modelo Normal ficar corrompido. Se isso acontecer, você pode excluir o modelo Normal corrompido e ele será recriado automaticamente na próxima vez que você abrir o Word. No entanto, as macros que foram armazenadas no modelo Normal não são recriadas.
Depurar suplementos VSTO do Office 2013 usando o Office 2013 ou o Office 2016
Se você estiver usando o Visual Studio 2015 e tiver as duas versões do Office instaladas lado a lado, o Visual Studio iniciará o Office 2016. Se você estiver usando o Visual Studio 2013, o Visual Studio iniciará o Office 2013.
Se você quiser depurar seu suplemento VSTO usando uma versão diferente do Office (2013 ou 2016), abra o Project Designer e, na guia Depurar, escolha o botão de opção Iniciar programa externo. Em seguida, navegue até o local do executável do aplicativo do Office apropriado.
Comportamento de F10 e F11
Quando você começa a depurar um projeto do Office, F10 e F11 não têm o mesmo comportamento que quando você começa a depurar outros projetos Visual Basic ou C#. Em projetos Visual Basic ou C#, o depurador pára na função principal; em projetos do Office, o 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 que em projetos Visual Basic e C#.
Exibir exceções
Devido à maneira como o código gerenciado interage com o código não gerenciado, o Visual Studio não exibe erros que são lançados por aplicativos do Microsoft Office. Por exemplo, se um suplemento VSTO criado usando ferramentas de desenvolvimento do Office no Visual Studio lança uma exceção, o aplicativo do Microsoft Office continua sem exibir um erro. Para ver esses erros, defina o depurador para quebrar em exceções de tempo de execução de linguagem comum. Para obter mais informações, consulte Gerenciar exceções com o depurador.
Se você definir o depurador para quebrar em exceções de tempo de execução de linguagem comum, todas as exceções agora serão invadidas pelo depurador, incluindo aquelas que você manipulou e algumas exceções de primeira chance do próprio tempo de execução, que podem não ser relevantes para o seu projeto. Erros referentes ao msosec não sendo encontrado aparecem em todos os projetos, mas são seguros para ignorar. Essas exceções do msosec não afetarão sua solução.
Você também pode usar Try... Capture instruções em torno 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 habilitar esse recurso para que você possa ver os erros que são gerados. Para obter mais informações, consulte Depuração just-in-time no Visual Studio.
Argumentos de linha de comando
Se a Ação Iniciar na página de propriedades Depurar estiver definida como Iniciar Projeto, o Visual Studio não usará argumentos de linha de comando ao depurar o projeto, mesmo se você tiver especificado argumentos de linha de comando como opções de início. Se desejar usar argumentos de linha de comando ao iniciar a depuração, selecione uma Ação Iniciar diferente de Iniciar Projeto.
Controle do código-fonte
As propriedades de depuração não são compartilhadas entre vários usuários sob controle do código-fonte. Projetos Visual Basic e C# armazenam as propriedades de depuração em um arquivo específico do usuário (ProjectName.vbproj.user ou ProjectName.csproj.user), e esse arquivo não está sob controle do código-fonte. Se mais de uma pessoa estiver depurando, cada pessoa deverá inserir as propriedades de depuração manualmente.
Depurar conjuntos de dados armazenados em cache em um projeto de nível de documento
Toda vez que você cria um projeto, o conjunto de dados é esvaziado e recriado. Se você deseja depurar um conjunto de dados armazenado em cache, você deve abrir o documento fora do Visual Studio e, em seguida, anexar o depurador.
Depurar projetos de documento do Word com base no formato de documento do Word 97-2003 (*.doc)
Para depurar um projeto de documento do Word com base no formato de documento do Word 97-2003 (/.doc*), você deve adicionar a pasta do projeto à lista de pastas confiáveis. Para obter mais informações sobre como fazer isso, consulte Conceder confiança a documentos.
Depurar suplementos desativados
Os aplicativos do Microsoft Office podem desabilitar suplementos VSTO que se comportam inesperadamente. Um aplicativo do Microsoft Office desabilita os suplementos VSTO para impedir que o código problemático seja carregado sempre que o aplicativo for iniciado. No entanto, também é fácil causar um comportamento inesperado durante a depuração típica. Para obter informações sobre como reativar suplementos VSTO, consulte Como: reativar um suplemento VSTO que foi desabilitado.
Há dois tipos de desabilitação que os aplicativos do Microsoft Office usam para suplementos VSTO: desabilitação rígida e desabilitação flexível.
Difícil desativação
A desativação rígida pode ocorrer quando um suplemento VSTO faz com que o aplicativo feche inesperadamente. Isso também pode ocorrer no computador de desenvolvimento se você parar o depurador enquanto o Startup manipulador de eventos no suplemento VSTO estiver em execução. Quando um suplemento VSTO é desabilitado, ele aparece na lista Itens desabilitados no aplicativo.
Se um aplicativo do Office desabilitar um suplemento VSTO criado usando ferramentas de desenvolvimento do Office no Visual Studio, o aplicativo desabilitará somente o suplemento VSTO que causou a falha. Outros suplementos VSTO criados usando ferramentas de desenvolvimento do Office no Visual Studio para esse aplicativo do Office continuarão a carregar.
Desativação suave
A desativação suave pode ocorrer quando um suplemento VSTO produz um erro que não faz com que o aplicativo feche inesperadamente. Por exemplo, um aplicativo pode desabilitar suavemente um suplemento VSTO se ele lançar uma exceção não tratada enquanto o Startup manipulador de eventos estiver em execução. Quando um suplemento VSTO é desabilitado suavemente, ele aparece na lista Suplementos de aplicativo inativo no aplicativo, e o aplicativo altera o valor da entrada do Registro LoadBehavior para o suplemento VSTO para indicar que ele está descarregado. Para obter mais informações sobre a entrada do Registro LoadBehavior , consulte Entradas do Registro para suplementos VSTO.
Solucionar problemas de erros de instalação usando o Visualizador de Eventos
O Visual Studio Tools for Office runtime grava mensagens para o Visualizador de Eventos no Windows para todas as exceções que são lançadas quando você instala ou desinstala soluções do Office. Você pode usar essas mensagens para resolver problemas de instalação e implantação.
Solucionar 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 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 criando variáveis de ambiente.
Para exibir cada erro em uma caixa de mensagem, crie uma variável de ambiente chamada VSTO_SUPPRESSDISPLAYALERTS e defina-a como 0 (zero). Você pode suprimir as mensagens excluindo a variável de ambiente ou definindo-a como 1 (um).
Para gravar os erros em um arquivo de log, crie uma variável de ambiente chamada VSTO_LOGALERTS e defina-a como 1 (um). O tempo de execução do Visual Studio Tools for Office cria o arquivo de log na pasta que contém o manifesto de implantação para o suplemento VSTO ou na pasta que contém o documento ou a pasta de trabalho associada à personalização. Se isso falhar, o tempo de execução do Visual Studio Tools for Office criará o arquivo de log na pasta %TEMP% local. Para suplementos VSTO no nível do aplicativo, o nome padrão é add-in name.vsto.log. Para projetos de nível de documento, o nome do arquivo de log é o nome do documento.extensão.log, como ExcelWorkbook1.xlsx.log. Para interromper os erros de log, exclua a variável de ambiente ou defina-a como 0 (zero).