Tutorial: aprenda a depurar código do Visual Basic usando o Visual Studio

Artigo
09/27/2022

Aplica-se a:Visual Studio Visual Studio para Mac Visual Studio Code

Este artigo apresenta os recursos do depurador do Visual Studio passo a passo. Caso deseje obter uma exibição de nível superior das funcionalidades do depurador, confira Introdução ao depurador. Quando você depura seu aplicativo, isso normalmente significa executar o aplicativo com o depurador anexado. Quando você faz isso, o depurador fornece várias maneiras de mostrar o que o código está fazendo enquanto é executado. Você pode percorrer o código e examinar os valores armazenados em variáveis, definir inspeções em variáveis para ver quando os valores mudam, examinar o caminho de execução do código, ver se um branch de código está em execução e assim por diante. Se esta for sua primeira tentativa de depurar um código, leia Como depurar para iniciantes absolutos antes continuar neste artigo.

Embora o aplicativo de demonstração seja Visual Basic, a maioria dos recursos é aplicável a C#, C++, F#, Python, JavaScript e outras linguagens compatíveis com o Visual Studio (F# não dá suporte a Editar e continuar. F# e JavaScript não dão suporte à janela Autos ). As capturas de tela estão no Visual Basic.

Neste tutorial, você irá:

Iniciar o depurador e atingir os pontos de interrupção.
Aprender os comandos para percorrer o código no depurador
Inspecionar variáveis em dicas de dados e janelas do depurador
Examinar a pilha de chamadas

Pré-requisitos

Você deve ter o Visual Studio 2019 instalado e a carga de trabalho de desenvolvimento multiplataforma do .NET Core .

Se você ainda não instalou o Visual Studio, acesse a página de downloads do Visual Studio para instalá-lo gratuitamente.

Se você precisar instalar a carga de trabalho, mas já tiver o Visual Studio, acesseFerramentas e Recursos doTools> Get..., que abre o Instalador do Visual Studio. O Instalador do Visual Studio é iniciado. Escolha a carga de trabalho de desenvolvimento multiplataforma do .NET Core e escolha Modificar.

Se você ainda não instalou o Visual Studio, acesse a página de downloads do Visual Studio para instalá-lo gratuitamente.

Se você precisar instalar a carga de trabalho, mas já tiver o Visual Studio, acesseFerramentas e Recursos doTools> Get..., que abre o Instalador do Visual Studio. O Instalador do Visual Studio é iniciado. Escolha a carga de trabalho Desenvolvimento de área de trabalho do .NET e, em seguida, selecione Modificar.

Criar um projeto

Primeiro, você criará um projeto de aplicativo de console do .NET Core. O tipo de projeto inclui todos os arquivos de modelo que você precisará, mesmo sem adicionar nada!

Abra o Visual Studio.

Se a janela inicial não estiver aberta, escolhaJanela IniciarArquivo>.
Na tela Iniciar, selecione Criar um novo projeto.
Na janela Criar um novo projeto , insira ou digite o console na caixa de pesquisa. Em seguida, escolha Visual Basic na lista Linguagem de programação e, em seguida, escolha Windows na lista Plataforma.

Depois de aplicar os filtros de linguagem e plataforma, escolha o modelo de Aplicativo de Console para .NET Core e escolha Avançar.

Observação

Se você não vir o modelo do Aplicativo de Console , poderá instalá-lo na janela Criar um novo projeto . Na mensagem Não encontrou o que precisa?, escolha o link Instalar mais ferramentas e recursos. Em seguida, no Instalador do Visual Studio, escolha a carga de trabalho de desenvolvimento multiplataforma do .NET Core.
Na janela Configurar seu novo projeto, digite ou insira a depuração de introdução na caixa de nome do projeto . Em seguida, escolha Avançar.
Escolha a estrutura de destino recomendada (.NET Core 3.1) ou .NET 5 e escolha Criar.

O Visual Studio abre seu novo projeto.

Abra o Visual Studio.

Se a janela inicial não estiver aberta, escolhaJanela IniciarArquivo>.
Na tela Iniciar, selecione Criar um novo projeto.
Na janela Criar um novo projeto , insira ou digite o console na caixa de pesquisa. Em seguida, escolha Visual Basic na lista Linguagem de programação e, em seguida, escolha Windows na lista Plataforma.

Depois de aplicar os filtros de linguagem e plataforma, escolha o modelo de Aplicativo de Console para .NET Core e escolha Avançar.

Observação

Se você não vir o modelo de Aplicativo de Console , poderá instalá-lo na janela Criar um novo projeto . Na mensagem Não encontrou o que precisa?, escolha o link Instalar mais ferramentas e recursos. Em seguida, no Instalador do Visual Studio, escolha a carga de trabalho de desenvolvimento da área de trabalho do .NET.
Na janela Configurar seu novo projeto, digite ou insira a depuração de introdução na caixa de nome do projeto . Em seguida, escolha Avançar.
Na janela Informações Adicionais , verifique se a estrutura de destino recomendada é (.NET 6.0) e escolha Criar.

O Visual Studio abre seu novo projeto.

Criar o aplicativo

No Program.vb, substitua todo o código padrão pelo código a seguir:

Imports System

Class ArrayExample
    Public Shared Sub Main()
        Dim letters As Char() = {"f"c, "r"c, "e"c, "d"c, " "c, "s"c, "m"c, "i"c, "t"c, "h"c}
        Dim name As String = ""
        Dim a As Integer() = New Integer(9) {}

        For i As Integer = 0 To letters.Length - 1
            name += letters(i)
            a(i) = i + 1
            SendMessage(name, a(i))
        Next

        Console.ReadKey()
    End Sub

    Private Shared Sub SendMessage(ByVal name As String, ByVal msg As Integer)
        Console.WriteLine("Hello, " & name & "! Count to " & msg)
    End Sub
End Class

Inicie o depurador.

Pressione F5 (Depurar > Iniciar Depuração) ou o botão Iniciar Depuração na Barra de Ferramentas de Depuração.

F5 inicia o aplicativo com o depurador anexado ao processo do aplicativo, mas nós ainda não fizemos nada de especial para examinar o código. Portanto, o aplicativo apenas é carregado e a saída do console é exibida.
```
Hello, f! Count to 1
Hello, fr! Count to 2
Hello, fre! Count to 3
Hello, fred! Count to 4
Hello, fred ! Count to 5
Hello, fred s! Count to 6
Hello, fred sm! Count to 7
Hello, fred smi! Count to 8
Hello, fred smit! Count to 9
Hello, fred smith! Count to 10
```
Neste tutorial, vamos analisar melhor esse aplicativo usando o depurador e analisar os recursos do depurador.
Pare o depurador pressionando o botão de parada vermelha (Shift + F5).
Na janela do console, pressione uma tecla para fechar a janela do console.

Pressione F5 (Depurar > Iniciar Depuração) ou selecione o botão iniciar depuração verde na Barra de Ferramentas de Depuração.

F5 inicia o aplicativo com o depurador anexado ao processo do aplicativo, mas nós ainda não fizemos nada de especial para examinar o código. Portanto, o aplicativo apenas é carregado e a saída do console é exibida.
```
Hello, f! Count to 1
Hello, fr! Count to 2
Hello, fre! Count to 3
Hello, fred! Count to 4
Hello, fred ! Count to 5
Hello, fred s! Count to 6
Hello, fred sm! Count to 7
Hello, fred smi! Count to 8
Hello, fred smit! Count to 9
Hello, fred smith! Count to 10
```
Neste tutorial, vamos analisar melhor esse aplicativo usando o depurador e analisar os recursos do depurador.
Pare o depurador pressionando (Shift + F5) ou selecione o botão de depuração de parada vermelha na Barra de Ferramentas de Depuração.
Na janela do console, pressione uma tecla para fechar a janela do console.

Definir um ponto de interrupção e iniciar o depurador

No loop For da função Main, defina um ponto de interrupção clicando na margem esquerda da seguinte linha de código:

name += letters(i)

Um círculo vermelho é exibido onde você define o ponto de interrupção.

Os pontos de interrupção são um dos recursos mais básicos e essenciais da depuração confiável. Um ponto de interrupção indica quando o Visual Studio deve suspender o código em execução para que você possa examinar os valores das variáveis ou o comportamento de memória ou se uma ramificação de código está sendo executada ou não.
Pressione F5 ou o botão Iniciar Depuração, o aplicativo é iniciado e o depurador é executado até a linha de código em que você define o ponto de interrupção.

A seta amarela representa a instrução na qual o depurador ficou em pausa, que também suspende a execução do aplicativo no mesmo ponto (essa instrução ainda não foi executada).

Se o aplicativo ainda não estiver em execução, F5 iniciará o depurador e o interromperá no primeiro ponto de interrupção. Caso contrário, F5 continuará executando o aplicativo até o próximo ponto de interrupção.

Os pontos de interrupção são um recurso útil quando você sabe qual linha ou seção de código deseja examinar em detalhes. Para obter informações sobre os diferentes tipos de pontos de interrupção que você pode definir, como pontos de interrupção condicionais, consulte Usando pontos de interrupção.

No loop For da função Main, defina um ponto de interrupção clicando na margem esquerda da seguinte linha de código:

name += letters(i)

Aparece um círculo vermelho no qual você definiu o ponto de interrupção.

Os pontos de interrupção são um dos recursos mais básicos e essenciais da depuração confiável. Um ponto de interrupção indica quando o Visual Studio deve suspender o código em execução para que você possa examinar os valores das variáveis ou o comportamento de memória ou se uma ramificação de código está sendo executada ou não.
Pressione F5 (Depurar > Iniciar Depuração) ou o botão Iniciar Depuração na Barra de Ferramentas de Depuração, o aplicativo é iniciado e o depurador é executado na linha de código em que você define o ponto de interrupção.

A seta amarela representa a instrução na qual o depurador ficou em pausa, que também suspende a execução do aplicativo no mesmo ponto (essa instrução ainda não foi executada).

Se o aplicativo ainda não estiver em execução, F5 iniciará o depurador e o interromperá no primeiro ponto de interrupção. Caso contrário, F5 continuará executando o aplicativo até o próximo ponto de interrupção.

Os pontos de interrupção são um recurso útil quando você sabe qual linha ou seção de código deseja examinar em detalhes. Para obter informações sobre os diferentes tipos de pontos de interrupção que você pode definir, como pontos de interrupção condicionais, consulte Usando pontos de interrupção.

Navegar pelo código no depurador usando comandos de etapa

Geralmente, usamos atalhos de teclado aqui porque essa é uma boa maneira de executar o aplicativo rapidamente no depurador (os comandos equivalentes, como os comandos de menu, são mostrados entre parênteses).

Enquanto pausado no For loop no Main método, pressione F11 (ou escolha Depurar > Passo a Passo) duas vezes para avançar para a chamada do SendMessage método.

Depois de pressionar F11 duas vezes, você deve estar nessa linha de código:

SendMessage(name, a(i))
Pressione F11 mais uma vez para entrar no SendMessage método.

O ponteiro amarelo avança para o SendMessage método.

F11 é o comando Intervir, que avança a execução do aplicativo uma instrução por vez. F11 é uma boa maneira de examinar o fluxo de execução com o máximo de detalhes. (Para mover-se mais rapidamente por meio do código, mostramos algumas outras opções também.) Por padrão, o depurador ignora o código não usuário (se você quiser mais detalhes, consulte Just My Code).

Digamos que você tenha terminado de examinar o SendMessage método e deseja sair do método, mas permanecer no depurador. Você pode fazer isso usando o comando Depuração Circular.
Pressione Shift + F11 (ou Depurar > Sair).

Esse comando retoma a execução do aplicativo (e avança o depurador) até que o método ou função atual retorne.

Você deve estar de volta ao For loop no Main método, pausado na chamada do SendMessage método.
Pressione F11 várias vezes até voltar à chamada de SendMessage método novamente.
Durante a pausa na chamada do método, pressione F10 (ou escolha Depurar > Passo a Passo) uma vez.

Observe desta vez que o depurador não entra no SendMessage método. F10 avança o depurador sem intervir em funções ou métodos no código do aplicativo (o código ainda é executado). Pressionando F10 na chamada do método SendMessage (em vez de F11), ignoramos o código de implementação de SendMessage (que, no momento, talvez não seja de nosso interesse). Para obter mais informações sobre diferentes maneiras de mover seu código, consulte Navegar código no depurador.

Neste artigo, usamos os atalhos de teclado, pois é uma boa maneira de obter rapidez na execução do aplicativo no depurador (comandos equivalentes, como comandos de menu, são mostrados em parênteses).

Enquanto pausado no For loop no Main método, pressione F11 (ou escolha Depurar > Passo a Passo) duas vezes para avançar para a chamada do SendMessage método.

Depois de pressionar F11 duas vezes, você deve estar nessa linha de código:

SendMessage(name, a(i))
Pressione F11 mais uma vez para entrar no SendMessage método.

O ponteiro amarelo avança para o SendMessage método.

F11 é o comando Step Into e avança a execução do aplicativo uma instrução por vez. F11 é uma boa maneira de examinar o fluxo de execução com mais detalhes. (Para mover-se mais rapidamente por meio do código, mostramos algumas outras opções também.) Por padrão, o depurador ignora o código não usuário (se você quiser mais detalhes, consulte Just My Code).

Digamos que você tenha terminado de examinar o SendMessage método e deseja sair do método, mas permanecer no depurador. Você pode fazer isso usando o comando Depuração Circular.
Pressione Shift + F11 (ou Depurar > Sair).

Esse comando retoma a execução do aplicativo (e avança o depurador) até que o método ou função atual retorne.

Você deve estar de volta ao For loop no Main método, pausado na chamada do SendMessage método.
Pressione F11 várias vezes até voltar à chamada de SendMessage método novamente.
Durante a pausa na chamada do método, pressione F10 (ou escolha Depurar > Passo a Passo) uma vez.

Observe desta vez que o depurador não entra no SendMessage método. F10 avança o depurador sem intervir em funções ou métodos no código do aplicativo (o código ainda é executado). Pressionando F10 na chamada do método SendMessage (em vez de F11), ignoramos o código de implementação de SendMessage (que, no momento, talvez não seja de nosso interesse). Para obter mais informações sobre diferentes maneiras de mover seu código, consulte Navegar código no depurador.

Navegar usando Executar até o Clique

Pressione F5 para avançar para o ponto de interrupção novamente.
No editor de código, role para baixo e passe o mouse sobre o Console.WriteLine método no método até que SendMessage o botão verde Executar para Clicar apareça à esquerda. A dica de ferramenta para o botão mostra "Realizar a execução até aqui".

Observação

O botão Executar para Clicar é novo no Visual Studio 2017. (Se você não vir o botão de seta verde, use F11 neste exemplo para avançar o depurador para o lugar certo.)
Clique no botão Executar para Clicar.

O depurador avança para o Console.WriteLine método.

O uso desse botão é semelhante à configuração de um ponto de interrupção temporário. Executar até o Clique é útil para abranger rapidamente uma região visível do código do aplicativo (você pode clicar em qualquer arquivo aberto).

Pressione F5 para avançar para o ponto de interrupção novamente.
No editor de código, role para baixo e passe o mouse sobre o Console.WriteLine método no método até que SendMessage o botão verde Executar para Clicar apareça à esquerda. A dica de ferramenta para o botão mostra "Realizar a execução até aqui".
Selecione o botão Executar para Clicar .

O depurador avança para o Console.WriteLine método.

O uso desse botão é semelhante à configuração de um ponto de interrupção temporário. Executar até o Clique é útil para abranger rapidamente uma região visível do código do aplicativo (você pode clicar em qualquer arquivo aberto).

Reinicie o aplicativo rapidamente

Clique no botão Reiniciar na Barra de Ferramentas de Depuração (Ctrl + Shift + F5).

Ao pressionar Reiniciar, você economiza tempo em comparação com a opção de parar o aplicativo e reiniciar o depurador. O depurador é pausado no primeiro ponto de interrupção que é atingido pela execução do código.

O depurador para novamente no ponto de interrupção que você definiu anteriormente dentro do For loop.

Para reiniciar seu aplicativo, pressione a combinação de teclas Ctrl + Shift + F5 , ela economiza tempo versus parar o aplicativo e reiniciar o depurador. O depurador é pausado no primeiro ponto de interrupção que é atingido pela execução do código.

O depurador para novamente no ponto de interrupção que você definiu anteriormente dentro do For loop.

Inspecionar variáveis com dicas de dados

Os recursos que permitem que você inspecione variáveis são uns dos mais úteis do depurador e há diferentes maneiras de fazer isso. Muitas vezes, ao tentar depurar um problema, você tenta descobrir se as variáveis estão armazenando os valores que elas deveriam conter em um momento específico.

Enquanto pausa na name += letters[i] instrução, passe o mouse sobre a letters variável e você verá seu valor padrão, o valor do primeiro elemento na matriz. "f"c
Em seguida, passe o mouse sobre a name variável e você verá seu valor atual, uma cadeia de caracteres vazia.
Pressione F5 (ou Depurar>Continuar) algumas vezes para iterar várias vezes através do For loop, pausando novamente no ponto de interrupção e passando o mouse sobre a variável cada name vez para verificar seu valor.

O valor da variável é alterado com cada iteração do For loop, mostrando valores de f, em seguida fr, e freassim por diante.

Muitas vezes, durante a depuração, você deseja uma maneira rápida de verificar valores de propriedade em variáveis, para ver se eles estão armazenando os valores que você espera que armazenem. As dicas de dados são uma boa maneira de fazer isso.

Enquanto pausa na name += letters[i] instrução, passe o mouse sobre a letters variável e você verá seu valor padrão, o valor do primeiro elemento na matriz. "f"c
Em seguida, passe o mouse sobre a name variável e você verá seu valor atual, uma cadeia de caracteres vazia.
Pressione F5 (ou Depurar>Continuar) algumas vezes para iterar várias vezes através do For loop, pausando novamente no ponto de interrupção e passando o mouse sobre a variável cada name vez para verificar seu valor.

O valor da variável é alterado com cada iteração do For loop, mostrando valores de f, em seguida fr, e freassim por diante.

Muitas vezes, durante a depuração, você deseja uma maneira rápida de verificar valores de propriedade em variáveis, para ver se eles estão armazenando os valores que você espera que armazenem. As dicas de dados são uma boa maneira de fazer isso.

Inspecionar variáveis com as janelas Autos e Locais

Examine a janela Autos na parte inferior do editor de códigos.

Se estiver fechado, abra-o enquanto estiver em pausa no depurador escolhendo Depurar>Windows>Autos.

Na janela Autos, veja as variáveis e seus valores atuais. A janela Autos mostra todas as variáveis usadas na linha atual ou a linha anterior (verifique a documentação para saber o comportamento específico a uma linguagem).
Em seguida, examine a janela Locais, em uma guia ao lado da janela Autos.
Expanda a letters variável para mostrar os elementos que ela contém.

A janela Locais mostra as variáveis que estão no escopo atual, ou seja, o contexto de execução atual.

Examine a janela Autos na parte inferior do editor de códigos.

Se estiver fechado, abra-o enquanto estiver em pausa no depurador escolhendo Depurar>Windows>Autos.

Na janela Autos, veja as variáveis e seus valores atuais. A janela Autos mostra todas as variáveis usadas na linha atual ou a linha anterior (verifique a documentação para saber o comportamento específico a uma linguagem).
Em seguida, examine a janela Locais, em uma guia ao lado da janela Autos.
Expanda a letters variável para mostrar os elementos que ela contém.

A janela Locais mostra as variáveis que estão no escopo atual, ou seja, o contexto de execução atual.

Definir uma inspeção

Na janela principal do editor de código, clique com o botão direito do mouse na name variável e escolha Adicionar Inspeção.

A janela Inspeção é aberta na parte inferior do editor de códigos. Você pode usar uma janela Inspeção para especificar uma variável (ou uma expressão) que deseja acompanhar.

Agora, você tem um conjunto de relógios name na variável e pode ver sua alteração de valor conforme se move pelo depurador. Ao contrário das outras janelas de variáveis, a janela Inspeção sempre mostra as variáveis que você está inspecionando (eles ficam esmaecidas quando estão fora do escopo).

Examinar a pilha de chamadas

Durante a pausa no loop For, clique na janela Pilha de Chamadas que fica aberta por padrão no painel inferior direito.

Se estiver fechado, abra-o enquanto estiver em pausa no depurador escolhendo Depurar> Pilha deChamadas doWindows>.
Clique em F11 algumas vezes até ver a pausa do depurador no SendMessage método. Examine a janela Pilha de Chamadas.

A janela Pilha de Chamadas mostra a ordem em que os métodos e as funções são chamados. A linha superior mostra a função atual (o método SendMessage neste aplicativo). A segunda linha mostra que SendMessage foi chamado por meio do método Main e assim por diante.

Observação

A janela Pilha de Chamadas é semelhante à perspectiva de Depuração em alguns IDEs, como o Eclipse.

A pilha de chamadas é uma boa maneira de examinar e entender o fluxo de execução de um aplicativo.

Você pode clicar duas vezes em uma linha de código para examinar esse código-fonte. Isso também altera o escopo atual que está sendo inspecionado pelo depurador. Essa ação não avança o depurador.

Você também pode usar os menus acessados ao clicar com o botão direito do mouse na janela Pilha de Chamadas para fazer outras coisas. Por exemplo, você pode inserir pontos de interrupção em funções especificadas, avançar o depurador usando Executar até o Cursor e examinar o código-fonte. Para obter mais informações, confira Como examinar a pilha de chamadas.

Enquanto estiver pausado no loop, clique na For janela Pilha de Chamadas , que é aberta por padrão no painel inferior direito.

Se estiver fechado, abra-o enquanto estiver em pausa no depurador escolhendo Depurar> Pilha deChamadas doWindows>.
Clique em F11 algumas vezes até ver a pausa do depurador no SendMessage método. Examine a janela Pilha de Chamadas.

A janela Pilha de Chamadas mostra a ordem em que os métodos e as funções são chamados. A linha superior mostra a função atual (o método SendMessage neste aplicativo). A segunda linha mostra que SendMessage foi chamado por meio do método Main e assim por diante.

Observação

A janela Pilha de Chamadas é semelhante à perspectiva de Depuração em alguns IDEs, como o Eclipse.

A pilha de chamadas é uma boa maneira de examinar e entender o fluxo de execução de um aplicativo.

Você pode clicar duas vezes em uma linha de código para examinar esse código-fonte. Isso também altera o escopo atual que está sendo inspecionado pelo depurador. Essa ação não avança o depurador.

Você também pode usar os menus acessados ao clicar com o botão direito do mouse na janela Pilha de Chamadas para fazer outras coisas. Por exemplo, você pode inserir pontos de interrupção em funções especificadas, avançar o depurador usando Executar até o Cursor e examinar o código-fonte. Para obter mais informações, confira Como examinar a pilha de chamadas.

Alterar o fluxo de execução

Pressione F11 duas vezes para executar o Console.WriteLine método.
Com o depurador pausado na chamada de SendMessage método, use o mouse para pegar a seta amarela (o ponteiro de execução) à esquerda e movê-la para cima uma linha, de volta para Console.WriteLine.
Pressione F11.

O depurador executa novamente o método Console.WriteLine (você vê isso na saída da janela do console).

Alterando o fluxo de execução, você pode fazer coisas como testar caminhos de execução de código diferentes ou executar novamente o código sem reiniciar o depurador.

Aviso

Geralmente, você precisa ter cuidado com esse recurso. Um aviso é exibido na dica de ferramenta. Outros avisos também podem ser exibidos. Ao mover o ponteiro não é possível reverter o aplicativo para um estado anterior.
Pressione F5 para continuar a execução do aplicativo.

Parabéns por concluir este tutorial.

Próximas etapas

Neste tutorial, você aprendeu como iniciar o depurador, percorrer o código e inspecionar variáveis. Talvez você queira obter uma visão geral dos recursos do depurador, com links para mais informações.

Introdução ao depurador