Partilhar via

Opções gerais de depuração

Para definir as opções do depurador do Visual Studio, selecione Opções de Ferramentas> e, em Depuração, marque ou desmarque as caixas de seleção ao lado das Opções gerais. Você pode restaurar todas as configurações padrão com Ferramentas>Configurações de Importação e Exportação>Redefinir todas as configurações. Para redefinir um subconjunto de configurações, salve suas configurações com o Assistente de Importação e Exportação de Configurações do antes de fazer as alterações que deseja testar e, em seguida, importe as configurações salvas depois.

Você pode definir as seguintes opções Gerais :

Perguntar antes de excluir todos os pontos de interrupção: Requer confirmação antes de concluir o comando Excluir todos os pontos de interrupção.

Interromper todos os processos quando um processo é interrompido: Simultaneamente interrompe todos os processos aos quais o depurador está ligado, quando ocorre uma interrupção.

Interromper quando exceções cruzam os limites do AppDomain ou os limites de código gerido/nativo: na depuração de modo de execução gerido ou misto, o Common Language Runtime pode capturar exceções que cruzam os limites do domínio de aplicação ou os limites de código gerido/nativo quando três condições forem verdadeiras:

  • Condição 1: Quando o código nativo chama o código gerenciado usando a Interoperabilidade COM e o código gerenciado gera uma exceção. Consulte Introdução à Interoperabilidade COM.

  • Condição 2: Quando o código gerenciado em execução no domínio do aplicativo 1 chama o código gerenciado no domínio do aplicativo 2 e o código no domínio do aplicativo 2 gera uma exceção. Consulte Programação com domínios de aplicação.

  • Condição 3: Quando o código chama uma função usando reflexão, e essa função gera uma exceção. Ver Reflexão.

  • Para as condições 2 e 3, a exceção às vezes é capturada pelo código gerido em mscorlib em vez de pelo Common Language Runtime. Esta opção não afeta a quebra de exceções detetadas pelo mscorlib.

Habilitar depuração no nível de endereço: habilita recursos avançados para depuração no nível de endereço (a janela Desmontagem, a janela Registros e pontos de paragem ao nível de endereço).

  • Mostrar desassemblagem se a origem não estiver disponível: Mostra automaticamente a janela Desassemblagem quando se depurar o código para o qual a origem não está disponível.

Habilitar filtros de ponto de interrupção: permite definir filtros em pontos de interrupção para que afetem apenas processos, threads ou computadores específicos.

Usar o novo Auxiliar de Exceção: Habilita o Auxiliar de Exceção que substitui o assistente de exceção. (O Auxiliar de exceção é suportado a partir do Visual Studio 2017)

Observação

Para código gerenciado, essa opção foi chamada anteriormente Ativar o assistente de exceção .

Ativar Apenas Meu Código: O depurador exibe e entra somente no código do usuário ("Meu Código"), ignorando o código do sistema e outro código otimizado ou que não tem símbolos de depuração.

  • Avisar se não houver código de usuário na inicialização (somente gerenciado): quando a depuração começar com Just My Code habilitado, essa opção avisa se não houver nenhum código de usuário ("Meu código").

Habilitar passo a passo no código-fonte do .NET Framework: Permite que o depurador entre no código-fonte do .NET Framework. Ativar esta opção desativa automaticamente Just My Code. Os símbolos do .NET Framework são baixados para um local de cache. Você pode alterar o local do cache na seção Depuração>Símbolos> com a opção Cache de símbolos neste diretório.

Habilitar passo a passo no código-fonte do .NET Framework: Permite que o depurador entre no código-fonte do .NET Framework. Ativar esta opção desativa automaticamente Just My Code. Os símbolos do .NET Framework são baixados para um local de cache. Você pode alterar o local do cache na seção Depuração>Símbolos com a opção Guardar símbolos na cache neste diretório.

Desotimizar automaticamente as funções depuradas quando possível (.Net 8+, Depuração dinâmica C++): Quando selecionado, desotimiza as funções depuradas para uma experiência de depuração mais abrangente.

Suprimir a otimização JIT na carga do módulo (somente gerenciado): Desabilita a otimização JIT do código gerenciado quando um módulo é carregado e o JIT é compilado enquanto o depurador está conectado. Desativar a otimização pode facilitar a depuração de alguns problemas, embora em detrimento do desempenho. Se você estiver usando Just My Code, suprimir a otimização JIT pode fazer com que o código que não é do usuário apareça como código de usuário ("Meu Código"). Para obter mais informações, consulte a otimização e depuração JIT em e.

Configurar o uso de imagens pré-compiladas (somente gerenciado): quando você seleciona esse link, a caixa de diálogo Opções do depurador do Visual Studio é aberta. Para habilitar a opção, marque a caixa de seleção Impedir o uso de imagens pré-compiladas no carregamento do módulo e selecione OK. Quando selecionado, desativa o carregamento de NGEN ou imagens pré-compiladas prontas para carregar (RDR).

Impedir o uso de imagens pré-compiladas na carga do módulo (somente gerenciado, redefine na reinicialização): quando selecionado, desativa o carregamento de imagens pré-compiladas NGEN ou prontas para carregar (RDR).

Configurar depuração Just-in-Time: Quando você seleciona esse link, a caixa de diálogo Opções do Depurador do Visual Studio é aberta. Para habilitar a opção, marque a caixa de seleção para habilitar Just-in-Time debugging para esses tipos de código. Selecione um ou mais tipos de código: Nativo e Gerenciado (.NET Framework) e selecione OK. Esta opção habilita a depuração Just-in-Time para o(s) tipo(s) de código selecionado(s).

Passo sobre propriedades e operadores (somente gerenciado): Impede que o depurador entre em propriedades e operadores no código gerenciado.

Ativar avaliação de propriedades e outras chamadas de função implícitas: ativa a avaliação automática de propriedades e chamadas de função implícitas nas janelas de variáveis e na caixa de diálogo QuickWatch.

  • Função de conversão de cadeia de caracteres de chamada em objetos em janelas de variáveis: Executa uma chamada de conversão de cadeia de caracteres implícita ao avaliar objetos em janelas de variáveis. O resultado é exibido como uma cadeia de caracteres em vez do nome do tipo. Aplica-se apenas durante a depuração em código C#. Essa configuração pode ser substituída pelo atributo DebuggerDisplay (consulte Usando o atributo DebuggerDisplay).

Ativar suporte de servidor de origem: Informa o depurador do Visual Studio sobre a obtenção de ficheiros de origem dos servidores de origem que implementam o protocolo SrcSrv (srcsrv.dll). Team Foundation Server e as Ferramentas de Depuração para Windows são dois servidores de origem que implementam o protocolo. Para obter mais informações sobre a instalação do SrcSrv, consulte a documentação do. Além disso, consulte Especificar símbolo (.pdb) e arquivos de origem.

Importante

Como a leitura arquivos .pdb pode executar código arbitrário nos arquivos, certifique-se de que você confia no servidor.

  • Imprimir mensagens de diagnóstico do servidor de origem na janela Saída: Quando o suporte ao servidor de origem está habilitado, essa configuração ativa a exibição de diagnóstico.

  • Permitir servidor de origem para assemblies de confiança parciais (somente gerenciados): Quando o suporte ao servidor de origem está habilitado, essa configuração substitui o comportamento padrão de não recuperar códigos-fonte para assemblies de confiança parciais.

  • Sempre execute comandos do servidor de origem não confiáveis sem avisar: Quando o suporte ao servidor de origem está habilitado, essa configuração substitui o comportamento padrão de avisar ao executar um comando não confiável.

Habilitar suporte ao Source Link: Informa o depurador do Visual Studio para descarregar os ficheiros de origem dos ficheiros .pdb que contêm informações de Source Link. Para obter mais informações sobre o link de origem, consulte a especificação do link de origem .

Importante

Como o Source Link baixa arquivos usando http ou https, certifique-se de confiar no arquivo .pdb .

  • Volte para a autenticação do Git Credential Manager para todas as solicitações de Link de Origem: Quando o suporte ao Link de Origem está habilitado e uma solicitação de Link de Origem falha na autenticação, o Visual Studio chama o Gerenciador de Credenciais do Git.

Realce toda a linha de origem para pontos de interrupção e instrução atual (somente C++): Quando o depurador realça um ponto de interrupção ou uma instrução atual, ele destaca a linha inteira.

Exigir que os arquivos de origem correspondam exatamente à versão original: Diz ao depurador para verificar se um arquivo de origem corresponde à versão do código-fonte usada para criar o executável que você está depurando. Quando a versão não corresponder, você será solicitado a encontrar uma fonte correspondente. Se uma fonte correspondente não for encontrada, o código-fonte não será exibido durante a depuração.

Redirecionar todo o texto da janela Saída para a janela Imediata: Envia todas as mensagens do depurador que normalmente apareceriam na janela Saída para a janela Imediata em vez de.

Mostrar estrutura bruta de objetos em janelas de variáveis: Desativa todas as personalizações de exibição de estrutura de objetos. Para obter mais informações sobre personalizações de exibição, consulte Criar modos de exibição personalizados de objetos gerenciados.

Ativar depuração JavaScript para ASP.NET (Chrome e Edge): ativa o depurador de script para aplicativos ASP.NET. Na primeira utilização no Chrome, poderá ter de iniciar sessão no navegador para ativar as extensões do Chrome instaladas. Desative essa opção para reverter para o comportamento herdado.

Ativar depuração JavaScript para ASP.NET (Chrome, Edge e IE): ativa o depurador de script para aplicativos ASP.NET. Na primeira utilização no Chrome, poderá ter de iniciar sessão no navegador para ativar as extensões do Chrome instaladas. Desative essa opção para reverter para o comportamento herdado.

Carregar exportações de DLL (somente nativo): Carrega tabelas de exportação de DLL. As informações de símbolos das tabelas de exportação de DLL podem ser úteis se estiver a trabalhar com mensagens do Windows, procedimentos Windows (WindowProcs), objetos COM ou marshaling, ou qualquer DLL para a qual não tenha símbolos. A leitura de informações de exportação de DLL envolve alguma sobrecarga. Portanto, esse recurso é desativado por padrão.

  • Para ver quais símbolos estão disponíveis na tabela de exportação de uma dll, use dumpbin /exports. Os símbolos estão disponíveis para qualquer dll de sistema de 32 bits. Ao ler a dumpbin /exports saída, você pode ver o nome exato da função, incluindo caracteres não alfanuméricos. Isso é útil para definir um ponto de interrupção em uma função. Nomes de função de tabelas de exportação DLL podem aparecer truncados em outras partes do depurador. As chamadas são listadas na ordem de chamada, com a função atual (a mais profundamente aninhada) no topo. Para obter mais informações, consulte dumpbin /exports.

Ignorar exceções de acesso à memória da GPU se os dados gravados não mudaram o valor: Ignora as condições de corrida que foram detetadas durante a depuração se os dados não mudaram. Para obter mais informações, consulte Debugging GPU Code.

Avisar ao usar visualizadores de depurador personalizados contra processos potencialmente inseguros (somente gerenciados): o Visual Studio avisa quando você estiver usando um visualizador de depurador personalizado que esteja executando código no processo depurado, porque ele pode estar executando código não seguro.

Habilitar o alocador de heap de depuração do Windows (somente nativo): Habilita o heap de depuração do Windows para melhorar o diagnóstico do heap. Habilitar esta opção afeta o desempenho da depuração.

Ativar Ferramentas de Diagnóstico durante a depuração: A janela Ferramentas de Diagnóstico aparece enquanto você está depurando.

Mostrar tempo decorrido PerfTip durante a depuração: A janela de código exibe o tempo decorrido de uma determinada chamada de método quando você está depurando.

Ativar Hot Reload: Ativa a funcionalidade Hot Reload durante a depuração.

  • Aplicar automaticamente as alterações ao continuar (somente nativo): o Visual Studio compila e aplica automaticamente quaisquer alterações de código pendentes feitas ao continuar o processo a partir de um estado de interrupção. Se não estiver selecionado, você pode optar por aplicar alterações usando o item Aplicar alterações de código no menu de depuração.

  • Avisar sobre código obsoleto (somente nativo): Receba avisos sobre código obsoleto.

Mostrar botão Executar para clicar durante a depuração: quando essa opção é selecionada, o botão Executar para clicar é mostrado durante a depuração.

Fechar automaticamente a consola quando a depuração parar: Indica ao Visual Studio para fechar a consola no final de uma sessão de depuração.

Ativar avaliação rápida de expressão (somente gerenciado): Permite que o depurador tente uma avaliação mais rápida simulando a execução de propriedades e métodos simples.

Carregar símbolos de depuração em processo externo (somente nativo): habilita essa otimização de memória durante a depuração.

Leve o Visual Studio para o primeiro plano ao interromper no depurador: Alterna-o para o primeiro plano quando se pausa no depurador.

Mantenha as dicas de dados expandidas abertas até clicar fora: quando esta opção está ativada, uma dica de dados expandida permanece aberta até que se clique fora dela.

Ative o nó Fontes Externas no Explorador de Soluções: Quando selecionado, mostra o código descompilado no nó Fontes Externas.

Descompilar automaticamente para o código-fonte quando necessário (somente gerenciado): Quando selecionado, descompila automaticamente o código .NET externo ao entrar em código externo.

Realce a instrução atual e as instruções com pontos de interrupção: quando o depurador destaca um ponto de interrupção ou uma instrução atual, ele destaca toda a linha.

Mostrar valores de variáveis embutidos no editor durante a depuração: Exiba os valores das variáveis na instrução realçada no depurador.

  • Mostrar valores de retorno em linha: Exibir os valores de retorno para a instrução realçada no depurador.

  • Mostrar valores dos argumentos de uma função em linha: Apresenta os valores dos argumentos de função na instrução destacada no depurador.

  • Mostrar valores de expressões da linha atual em linha: Mostrar os valores das expressões na linha atual no depurador.

Opções disponíveis em versões mais antigas do Visual Studio

Se você estiver usando uma versão mais antiga do Visual Studio, algumas outras opções podem estar presentes.

Habilitar Ferramentas de Desenvolvedor do Microsoft Edge para Aplicações JavaScript UWP (Experimental): Habilita Ferramentas de Desenvolvedor para Aplicações JavaScript UWP no Microsoft Edge.

Ativar o depurador JavaScript do Chrome herdado para ASP.NET: ativa o depurador de script JavaScript do Chrome herdado para aplicativos ASP.NET. Na primeira utilização no Chrome, poderá ter de iniciar sessão no navegador para ativar as extensões do Chrome instaladas.

Ativar o assistente de exceção: Para código gerenciado, habilita o assistente de exceção. A partir do Visual Studio 2017, o Auxiliar de Exceção substituiu o assistente de exceção.

Desenrolar a pilha de chamadas em exceções não tratadas: Faz com que a janela Pilha de Chamadas reverta a pilha de chamadas até ao ponto anterior à ocorrência da exceção não tratada.

Use uma maneira experimental de iniciar a depuração JavaScript do Chrome ao executar o Visual Studio como administrador: Diz ao Visual Studio para tentar uma nova maneira de iniciar o Chrome durante a depuração de JavaScript.

Avisar se não houver símbolos no lançamento (somente nativo): Exibe uma caixa de diálogo de aviso quando se depura um programa para o qual o debugger não tem informações de símbolos.

Avisar se a depuração de script estiver desativada na inicialização: Exibe uma caixa de diálogo de aviso quando o depurador é iniciado com a depuração de script desabilitada.

Ver também

  • Last updated on