Tutorial: Depurar um aplicativo de console do .NET usando o Visual Studio

Este tutorial apresenta as ferramentas de depuração disponíveis no Visual Studio.

Importante

Todos os atalhos de teclado são baseados nos padrões do Visual Studio. Os atalhos de teclado podem variar, para obter mais informações, consulte atalhos de teclado no Visual Studio.

Pré-requisitos

Este tutorial funciona com o aplicativo de console que você cria em Criar um aplicativo de console .NET usando o Visual Studio.

Usar a configuração de build de depuração

Debug e Release são as configurações de build internas do Visual Studio. Use a configuração de build de Debug para depuração e a configuração de build de Release para a distribuição final.

Na configuração de Depuração, um programa é compilado com informações de depuração simbólicas completas e sem otimização. A otimização complica a depuração, pois a relação entre o código-fonte e as instruções geradas é mais complexa. A configuração de lançamento de um programa não tem informações simbólicas de depuração e é totalmente otimizada.

Por padrão, o Visual Studio usa a configuração de build de depuração para que você não precise alterá-la antes da depuração.

1. Inicie o Visual Studio.

2. Abra o projeto que você criou em Criar um aplicativo de console .NET usando o Visual Studio.

   A configuração de build atual é mostrada na barra de ferramentas. A imagem da barra de ferramentas a seguir mostra que o Visual Studio está configurado para compilar a versão de depuração do aplicativo:

   

Definir um ponto de interrupção

Um ponto de interrupção interrompe temporariamente a execução do aplicativo antes que a linha com o ponto de interrupção seja executada.

1. Defina um ponto de interrupção na linha que exibe o nome, a data e a hora clicando na margem esquerda da janela de código nessa linha. A margem esquerda está à esquerda dos números das linhas. Outras maneiras de definir um ponto de interrupção são colocando o cursor na linha de código e pressionando F9 ou escolhendo Depurar>Ponto de Interrupção na barra de menus.

   Como mostra a imagem a seguir, o Visual Studio indica a linha na qual o ponto de interrupção é definido realçando-o e exibindo um ponto vermelho na margem esquerda.

   

2. Pressione F5 para executar o programa no modo de Depuração. Outra maneira de iniciar a depuração é escolhendo Depurar>Iniciar Depuração no menu.

3. Insira uma cadeia de caracteres na janela do console quando o programa solicitar um nome e pressione Enter.

4. A execução do programa é interrompida quando atinge o ponto de interrupção e antes da execução do Console.WriteLine método. A janela Locals exibe os valores das variáveis definidas no método em execução no momento.

   

Usar a janela Imediata

A janela Imediata permite que você interaja com o aplicativo que está depurando. Você pode alterar interativamente o valor das variáveis para ver como ela afeta seu programa.

1. Se a janela Imediata não estiver visível, exiba-a escolhendo Depurar>o Windows>Immediate.

2. Insira name = "Gracie" na janela Imediato e pressione a tecla Enter .

3. Insira currentDate = DateTime.Parse("2026-01-14T17:25:00Z").ToUniversalTime() na janela Imediato e pressione a tecla Enter .

   A janela Imediata exibe o valor da variável de cadeia de caracteres e as propriedades do DateTime valor. Além disso, os valores das variáveis são atualizados na janela Locais .

   

4. Pressione F5 para continuar a execução do programa. Outra maneira de continuar é escolhendo Depurar>Continuar no menu.

   Os valores exibidos na janela do console correspondem às alterações feitas na janela Imediata .

5. Pressione qualquer tecla para sair do aplicativo e parar a depuração.

Definir um ponto de interrupção condicional

O programa exibe a cadeia de caracteres que o usuário insere. O que acontece se o usuário não inserir nada? Você pode testar isso com um recurso útil de depuração chamado interrupção condicional.

1. Clique com o botão direito do mouse no ponto vermelho que representa o ponto de interrupção. No menu de contexto, selecione Condições para abrir a caixa de diálogo Configurações do Ponto de Interrupção . Selecione a caixa para Condições se ela ainda não estiver selecionada.

   

2. Para a Expressão Condicional, insira o código a seguir no campo de texto.

   string.IsNullOrEmpty(name)
   

   String.IsNullOrEmpty(name)
   

   Sempre que o ponto de interrupção for atingido, o depurador chamará o método String.IsNullOrEmpty(name) e irá interromper nesta linha somente se a chamada do método retornartrue.

   Em vez de uma expressão condicional, você pode especificar uma contagem de ocorrências, que interrompe a execução do programa antes que uma instrução seja executada um número especificado de vezes. Outra opção é especificar uma condição de filtro, que interrompe a execução do programa com base em atributos como um identificador de thread, nome do processo ou nome do thread.

3. Selecione Fechar para fechar a caixa de diálogo.

4. Inicie o programa com a depuração pressionando F5.

5. Na janela do console, pressione a tecla Enter quando solicitado a inserir seu nome.

6. Como a condição especificada (name é null ou String.Empty) foi atendida, a execução do programa é interrompida quando atinge o ponto de interrupção e antes da execução do Console.WriteLine método.

7. Selecione a janela Locals , que mostra os valores das variáveis que são locais para o método em execução no momento. Nesse caso, Main é o método em execução no momento. Observe que o valor da name variável é "", ou String.Empty.

8. Confirme se o valor é uma cadeia de caracteres vazia inserindo a instrução a seguir na janela Imediata e pressionando Enter. O resultado é true.

   ? name == String.Empty
   

   ? String.IsNullOrEmpty(name)
   

   O ponto de interrogação direciona a janela imediata para avaliar uma expressão.

   

9. Pressione F5 para continuar a execução do programa.

10. Pressione qualquer tecla para fechar a janela do console e parar a depuração.

11. Desmarque o ponto de interrupção clicando no ponto na margem esquerda da janela de código. Outras maneiras de limpar um ponto de interrupção são pressionando F9 ou escolhendo Depurar Alternar Ponto de Interrupção> enquanto a linha de código está selecionada.

Percorrer um programa

O Visual Studio também permite que você execute passo a passo linha por linha em um programa e monitore sua execução. Normalmente, você definiria um ponto de interrupção e seguiria o fluxo do programa por meio de uma pequena parte do código do programa. Como este programa é pequeno, você pode percorrer todo o programa.

1. Escolha Debug>Entrar. Outra maneira de depurar uma instrução de cada vez é pressionando F11.

   O Visual Studio realça e exibe uma seta ao lado da próxima linha de execução.

   

   Neste ponto, a janela Locais mostra que a args matriz está vazia e namecurrentDate tem valores padrão. Além disso, o Visual Studio abriu uma janela de console em branco.

2. Pressione F11. Agora, o Visual Studio destaca a próxima linha de execução. A janela Locals permanece inalterada e a janela do console permanece em branco.

   

3. Pressione F11. O Visual Studio destaca a instrução que inclui a atribuição da variável name. A janela Locals mostra que name é null e a janela do console exibe a string "Qual é o seu nome?".

4. Responda ao prompt inserindo uma cadeia de caracteres na janela do console e pressionando Enter. O console não responde e a cadeia de caracteres inserida não é exibida na janela do console, mas, no entanto, o Console.ReadLine método capturará sua entrada.

5. Pressione F11. O Visual Studio realça a instrução que inclui a atribuição da variável currentDate. A janela Locals mostra o valor retornado pela chamada para o Console.ReadLine método. A janela do console também exibe a cadeia de caracteres que você inseriu no prompt.

6. Pressione F11. A janela Locals mostra o valor da currentDate variável após a atribuição da DateTime.Now propriedade. A janela do console está inalterada.

7. Pressione F11. O Visual Studio chama o Console.WriteLine(String, Object, Object) método. A janela do console exibe a cadeia de caracteres formatada.

8. Escolha Depurar>Sair da etapa. Outra maneira de interromper a execução passo a passo é pressionando Shift+F11.

   A janela do console exibe uma mensagem e aguarda que você pressione uma tecla.

9. Pressione qualquer tecla para fechar a janela do console e parar a depuração.

Usar a configuração de build de versão

Depois de testar a versão Debug do seu aplicativo, você também deverá compilar e testar a versão Release. A versão de lançamento incorpora otimizações de compilador que, eventualmente, podem afetar negativamente o comportamento de um aplicativo. Por exemplo, otimizações de compilador que são projetadas para melhorar o desempenho podem criar condições de disputa em aplicativos multithread.

Para criar e testar a versão Release do seu aplicativo de console, altere a configuração de compilação na barra de ferramentas de Depuração para Release.

Quando você pressiona F5 ou escolhe Criar Solução no menu Criar, o Visual Studio compila a versão Release do aplicativo. Você pode testá-lo como fez com a versão Debug.

Próximas etapas

Neste tutorial, você usou as ferramentas de depuração do Visual Studio. No próximo tutorial, você publicará uma versão implantável do aplicativo.

Publicar um aplicativo de console do .NET usando o Visual Studio