Inspecionar variáveis e valores de retorno no depurador do Visual Studio

Quando você tenta depurar um problema, geralmente está tentando descobrir se as variáveis estão armazenando os valores que você espera que elas tenham em um determinado estado do aplicativo. Alguns dos recursos mais úteis do depurador são aqueles que permitem inspecionar variáveis.

Este artigo mostra como inspecionar variáveis e exibir valores de retorno usando o depurador no Visual Studio. O depurador fornece várias maneiras convenientes de executar essas tarefas, incluindo o seguinte:

• No editor de códigos, é possível exibir dicas de dados e valores de retorno em linha
• Nas janelas do depurador (janelas Autos, Locais e Monitoramento), você pode exibir valores de variáveis
• Em visualizadores, você pode exibir cadeias de caracteres grandes ou objetos .NET complexos

Esses recursos só estão disponíveis durante o debugging. Para saber como iniciar uma sessão de depuração, consulte Iniciar depuração e entrar no modo de paragem.

Exibir variáveis no editor de código

Muitas vezes, ao depurar, tu procuras uma forma rápida de verificar os valores das propriedades nos objetos no editor de código, e as sugestões de dados são uma boa forma de o fazer.

Enquanto estiver pausado no depurador, mova o rato sobre um objeto e irá ver o seu valor ou o seu valor de propriedade padrão.

Se a variável tiver propriedades, você poderá expandir o objeto para ver todas as suas propriedades.

Para obter informações detalhadas sobre como usar dicas de dados, consulte Exibir valores de dados em dicas de dados.

Definir uma monitorização em variáveis

Você pode usar uma janela de observação para especificar uma variável (ou uma expressão) que deseje monitorizar.

Durante a depuração, clique com o botão direito do mouse em um objeto no editor de códigos e escolha Adicionar inspeção. Abre-se uma janela de observação.

Neste exemplo, você tem um conjunto de observação no objeto e pode ver sua alteração de valor à medida que se move pelo depurador. Ao contrário das outras janelas variáveis , as janelas Watch sempre mostram as variáveis que você está assistindo (elas ficam acinzentadas quando fora do escopo).

Para obter informações detalhadas, consulte Definir um relógio usando o Watch e o QuickWatch Windows.

Inspecionar variáveis nas janelas do depurador (Autos e Locais)

As janelas Autos e Locals mostram valores variáveis enquanto se está a depurar. As janelas só estão disponíveis durante uma sessão de depuração. A janela Autos mostra as variáveis usadas em torno da instrução atual onde o depurador está pausado. A janela Locals mostra variáveis definidas no escopo local, que geralmente é a função ou método atual.

• Para abrir a janela Autos, durante a depuração, selecione Depurar >Windows>Autosou pressione Ctrl+Alt+V>A.

  A janela Autos está disponível para código C#, Visual Basic, C++ e Python, mas não para JavaScript ou F#.

• Para abrir a janela Locais, durante a depuração, selecione Depurar>Windows>Locaisou pressione Alt+4.

Matrizes e objetos expansíveis aparecem nas janelas Automáticos e Locais . Selecione a seta à esquerda do nome de uma variável para expandir a exibição para mostrar campos e propriedades. Aqui está um exemplo de um objeto System.IO.FileStream na janela Locals:

Um valor vermelho na janela Locals ou Autos significa que o valor foi alterado desde a última avaliação. A alteração pode ser de uma sessão de depuração anterior ou porque você alterou o valor na janela.

O formato numérico padrão nas janelas do depurador é decimal. Para alterá-lo para hexadecimal, clique com o botão direito do mouse na janela Locals ou Autos e selecione Hexadecimal Display. Essa alteração afeta todas as janelas do depurador.

Editar valores de variáveis na janela Autos ou Locais

Para editar os valores da maioria das variáveis nas janelas Autos ou Locais, clique duas vezes no valor e insira o novo valor.

Você pode inserir uma expressão para um valor, por exemplo, a + b. O depurador aceita a maioria das expressões de linguagem válidas.

No código C++ nativo, talvez seja necessário qualificar o contexto de um nome de variável. Para obter mais informações, consulte operador de contexto (C++).

Pesquisar na janela Autos ou Locais

Você pode pesquisar palavras-chave nas colunas Nome, Valor e Tipo da janela Autos ou Locals usando a barra de pesquisa acima de cada janela. Pressione ENTER ou selecione uma das setas para executar uma pesquisa. Para cancelar uma pesquisa em curso, selecione o ícone "x" na barra de pesquisa.

Use as setas para a esquerda e para a direita (Shift+F3 e F3, respectivamente) para navegar entre as correspondências encontradas.

Para tornar a sua pesquisa mais ou menos completa, utilize a lista pendente Pesquisa Mais Profunda no topo da janela de Autos ou Locais para selecionar quantos níveis de profundidade pretende pesquisar em objetos aninhados.

Fixar propriedades nas janelas Automáticos ou Locais

Você pode inspecionar rapidamente objetos pelas suas propriedades nas janelas de Automáticos e Locais com a ferramenta Propriedades Fixáveis . Para usar esta ferramenta, passe o rato sobre uma propriedade e selecione o ícone de alfinete que aparece ou clique com o botão direito do rato e selecione a opção Fixar Membro como Favorito no menu de contexto resultante. Isso move essa propriedade para o topo da lista de propriedades do objeto, e o nome e o valor da propriedade são exibidos na coluna Valor. Para desafixar uma propriedade, selecione novamente o ícone de pino ou escolha a opção Desafixar Membro dos Favoritos no menu de contexto.

pt-PT:

Você pode alternar entre nomes de propriedade e filtrar propriedades não fixadas ao visualizar a lista de propriedades do objeto nas janelas de Autos ou Locais. Você pode acessar cada opção selecionando os botões na barra de ferramentas acima das janelas Autos ou Locais.

Alterar o contexto da janela Autos ou Locais

Você pode usar a barra de ferramentas Debug Location para selecionar uma função, thread ou processo desejado, que altera o contexto das janelas Autos e Locals.

Para ativar a barra de ferramentas Local de Depuração, clique em uma área vazia da área da barra de ferramentas e selecione Local de Depuração na lista suspensa ou selecione Exibir>Barras de Ferramentas>Local de Depuração.

Defina um ponto de interrupção e inicie a depuração. Quando o ponto de interrupção é atingido, a execução é interrompida e você pode ver o local na barra de ferramentas Debug Location toolbar.

Diferenças de linguagem na janela Autos (C#, C++, Visual Basic, Python)

Diferentes linguagens de código exibem diferentes variáveis na janela Autos.

• Em C# e Visual Basic, a janela Autos exibe qualquer variável usada na linha atual ou anterior. Por exemplo, no código C# ou Visual Basic, declare as seguintes quatro variáveis:

       public static void Main()
       {
          int a, b, c, d;
          a = 1;
          b = 2;
          c = 3;
          d = 4;
       }
  

  Defina um ponto de interrupção na linha c = 3;e inicie o depurador. Quando a execução for pausada, a janela Autos exibirá:

  

  O valor de c é 0, porque a linha c = 3 ainda não foi executada.

• Em C++, a janela Autos exibe as variáveis usadas em pelo menos três linhas antes da linha atual onde a execução é pausada. Por exemplo, no código C++, declare seis variáveis:

       void main() {
           int a, b, c, d, e, f;
           a = 1;
           b = 2;
           c = 3;
           d = 4;
           e = 5;
           f = 6;
       }
  

  Defina um ponto de interrupção na linha e = 5; e execute o depurador. Quando a execução parar, a janela Autos exibirá:

  

  A variável e não foi inicializada, porque a linha e = 5 ainda não foi executada.

Ver valores de retorno na janela Automáticos

No exemplo a seguir, esse código C# adiciona os valores de retorno de duas funções:

static void Main(string[] args)
{
    int a, b, c, d;
    a = 1;
    b = 2;
    c = 3;
    d = 4;
    int x = sumVars(a, b) + subtractVars(c, d);
}

private static int sumVars(int i, int j)
{
    return i + j;
}

private static int subtractVars(int i, int j)
{
    return j - i;
}

Para visualizar os valores de retorno das chamadas dos métodos sumVars() e subtractVars() na janela Autos:

1. Defina um ponto de interrupção na linha int x = sumVars(a, b) + subtractVars(c, d);.

2. Inicie a depuração e, quando a execução parar no ponto de interrupção, selecione Step Over ou pressione F10. Você deve ver os seguintes valores de retorno na janela Autos:

   

Abra um visualizador para inspecionar variáveis

Enquanto você está depurando no Visual Studio, você pode exibir cadeias de caracteres grandes ou objetos complexos com visualizadores internos que tornam os dados mais fáceis de inspecionar. Por exemplo:

• O visualizador de strings mostra strings de texto, XML, HTML e JSON que são demasiado longas para uma dica de dados ou janela de depuração. Também pode ajudá-lo a identificar cadeias malformadas. Para obter mais informações, consulte Exibir cadeias de caracteres em um visualizador de cadeia de caracteres.
• Os visualizadores DataSet e IEnumerable mostram objetos de coleção .NET em um visualizador tabular. Para obter mais informações, consulte Visualizadores tabulares em objetos do Visual Studio).

Os visualizadores aparecem nas janelas Autos, sugestões de dados e outras janelas do depurador.

Para abrir um visualizador, deve-se estar em pausa durante a depuração. Passe o cursor sobre uma variável que tenha um valor de visualizador suportado e selecione o ícone de lupa .

Conteúdo relacionado

• O que é despiste de erros?
• Técnicas e ferramentas de depuração
• Primeiro olhar sobre a depuração
• janelas do depurador