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

Inicie o Visual Studio.

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 seguinte imagem da barra de ferramentas mostra que o Visual Studio está configurado para compilar na versão de Depuração do aplicativo:

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 fica à esquerda dos números de linha. 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>Alternar Ponto de Interrupção na barra de menus.

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

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

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

A execução do programa para quando ele atinge o ponto de interrupção e antes de o método Console.WriteLine ser executado. A janela Locais exibe os valores das variáveis que são definidas no método que está sendo executado no momento.

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

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

Insira currentDate = DateTime.Parse("2019-11-16T17:25:00Z").ToUniversalTime() na janela Imediata e pressione a tecla Enter.

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

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

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

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

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 de Ponto de Interrupção. Selecione a caixa de Condições se ela ainda não estiver selecionada.

Na Expressão Condicional, insira o código a seguir no campo que mostra o código de exemplo que é testado quando x é 5.

string.IsNullOrEmpty(name)

String.IsNullOrEmpty(name)

Em todas as ocorrências do ponto de interrupção, o depurador chama o método String.IsNullOrEmpty(name) e ele é interrompido nessa linha somente quando a chamada do método retorna true.

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 determinado número de vezes. Outra opção é especificar uma condição de filtro, que interrompe a execução do programa com base em atributos como identificador de thread, nome do processo ou nome do thread.

Selecione Fechar para fechar a caixa de diálogo.

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

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

Como a condição especificada (name é null ou String.Empty) foi atendida, a execução do programa é interrompida quando ele chega no ponto de interrupção e antes que o método Console.WriteLine seja executado.

Selecione a janela Locais, 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 variável name é "" ou String.Empty.

Confirme se o valor é uma cadeia de caracteres vazia inserindo a seguinte instrução 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.

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

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.

Limpe 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.

Escolha Depurar>Intervir. Outra maneira de depurar uma instrução por vez é pressionando F11.

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

C#

Visual Basic

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

Pressione F11. O Visual Studio agora destaca a próxima linha de execução. A janela Locais permanece inalterada e a janela do console permanece em branco.

C#

Visual Basic

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

Responda à solicitação 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 o método Console.ReadLine vai capturar a entrada.

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

Pressione F11. A janela Locais mostra o valor da variável currentDate após a atribuição da propriedade DateTime.Now. A janela do console não é alterada.

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

Escolha Depurar>Etapa de Saída. Outra maneira de interromper a execução passo a passo é pressionar Shift+F11.

A janela do console exibe uma mensagem e aguarda até que uma tecla seja pressionada.

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.

Inicie o Visual Studio.

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 seguinte imagem da barra de ferramentas mostra que o Visual Studio está configurado para compilar na versão de Depuração do aplicativo:

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 fica à esquerda dos números de linha. 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>Alternar Ponto de Interrupção na barra de menus.

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

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

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

A execução do programa para quando ele atinge o ponto de interrupção e antes de o método Console.WriteLine ser executado. A janela Locais exibe os valores das variáveis que são definidas no método que está sendo executado no momento.

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

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

Insira currentDate = DateTime.Parse("2019-11-16T17:25:00Z").ToUniversalTime() na janela Imediata e pressione a tecla Enter.

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

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

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

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

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 de Ponto de Interrupção. Selecione a caixa de Condições se ela ainda não estiver selecionada.

Na Expressão Condicional, insira o código a seguir no campo que mostra o código de exemplo que é testado quando x é 5.

string.IsNullOrEmpty(name)

String.IsNullOrEmpty(name)

Em todas as ocorrências do ponto de interrupção, o depurador chama o método String.IsNullOrEmpty(name) e ele é interrompido nessa linha somente quando a chamada do método retorna true.

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 determinado número de vezes. Outra opção é especificar uma condição de filtro, que interrompe a execução do programa com base em atributos como identificador de thread, nome do processo ou nome do thread.

Selecione Fechar para fechar a caixa de diálogo.

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

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

Como a condição especificada (name é null ou String.Empty) foi atendida, a execução do programa é interrompida quando ele chega no ponto de interrupção e antes que o método Console.WriteLine seja executado.

Selecione a janela Locais, 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 variável name é "" ou String.Empty.

Confirme se o valor é uma cadeia de caracteres vazia inserindo a seguinte instrução 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.

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

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.

Limpe 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.

Escolha Depurar>Intervir. Outra maneira de depurar uma instrução por vez é pressionando F11.

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

C#

Visual Basic

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

Pressione F11. O Visual Studio agora destaca a próxima linha de execução. A janela Locais permanece inalterada e a janela do console permanece em branco.

C#

Visual Basic

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

Responda à solicitação 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 o método Console.ReadLine vai capturar a entrada.

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

Pressione F11. A janela Locais mostra o valor da variável currentDate após a atribuição da propriedade DateTime.Now. A janela do console não é alterada.

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

Escolha Depurar>Etapa de Saída. Outra maneira de interromper a execução passo a passo é pressionar Shift+F11.

A janela do console exibe uma mensagem e aguarda até que uma tecla seja pressionada.

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.

Inicie o Visual Studio.

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 seguinte imagem da barra de ferramentas mostra que o Visual Studio está configurado para compilar na versão de Depuração do aplicativo:

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 fica à esquerda dos números de linha. 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>Alternar Ponto de Interrupção na barra de menus.

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

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

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

A execução do programa para quando ele atinge o ponto de interrupção e antes de o método Console.WriteLine ser executado. A janela Locais exibe os valores das variáveis que são definidas no método que está sendo executado no momento.

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

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

Insira currentDate = DateTime.Parse("2019-11-16T17:25:00Z").ToUniversalTime() na janela Imediata e pressione a tecla Enter.

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

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

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

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

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 de Ponto de Interrupção. Selecione a caixa de Condições se ela ainda não estiver selecionada.

Na Expressão Condicional, insira o código a seguir no campo que mostra o código de exemplo que é testado quando x é 5.

String.IsNullOrEmpty(name)

String.IsNullOrEmpty(name)

Em todas as ocorrências do ponto de interrupção, o depurador chama o método String.IsNullOrEmpty(name) e ele é interrompido nessa linha somente quando a chamada do método retorna true.

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 determinado número de vezes. Outra opção é especificar uma condição de filtro, que interrompe a execução do programa com base em atributos como identificador de thread, nome do processo ou nome do thread.

Selecione Fechar para fechar a caixa de diálogo.

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

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

Como a condição especificada (name é null ou String.Empty) foi atendida, a execução do programa é interrompida quando ele chega no ponto de interrupção e antes que o método Console.WriteLine seja executado.

Selecione a janela Locais, 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 variável name é "" ou String.Empty.

Confirme se o valor é uma cadeia de caracteres vazia inserindo a seguinte instrução 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.

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

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.

Limpe 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.

Escolha Depurar>Intervir. Outra maneira de depurar uma instrução por vez é pressionando F11.

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

C#

Visual Basic

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

Pressione F11. O Visual Studio agora destaca a próxima linha de execução. A janela Locais permanece inalterada e a janela do console permanece em branco.

C#

Visual Basic

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

Responda à solicitação 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 o método Console.ReadLine vai capturar a entrada.

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

Pressione F11. A janela Locais mostra o valor da variável currentDate após a atribuição da propriedade DateTime.Now. A janela do console não é alterada.

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

Escolha Depurar>Etapa de Saída. Outra maneira de interromper a execução passo a passo é pressionar Shift+F11.

A janela do console exibe uma mensagem e aguarda até que uma tecla seja pressionada.

Pressione qualquer tecla para fechar a janela do console e sair do modo de depuração.