Exibir e alterar os valores de variáveis com as Dicas de Dados no editor de código
Este artigo explora como trabalhar com o recurso DataTips no Visual Studio. As dicas de dados fornecem um modo conveniente de consultar as informações sobre variáveis em seu programa enquanto você depura o código. Quando você define pontos de interrupção em seu código e inicia a depuração, as dicas de dados ficam visíveis para as variáveis à medida que elas entram no escopo atual de execução. Você pode usar as dicas de dados para alterar o valor de uma variável no escopo e executar novamente o código no ponto de interrupção para ver o efeito da alteração.
Dica
Se você não estiver familiarizado com a depuração, leia Depuração para iniciantes absolutos e Técnicas e ferramentas de depuração antes de ler este artigo.
Pré-requisitos
Visual Studio. Se você não tiver o Visual Studio, acesse a páginaDownloads do Visual Studio para instalá-lo gratuitamente.
Algum código de programa a ser executado no depurador do Visual Studio.
Trabalhar com dicas de dados
As dicas de dados ficam visíveis durante uma sessão de depuração quando você tem pontos de interrupção definidos em seu código. Quando o depurador pausa a execução do programa em um ponto de interrupção, as dicas de dados ficam disponíveis para todas as variáveis no escopo atual.
Veja o processo:
Defina um ponto de interrupção no código e inicie a depuração selecionando Depurar>Iniciar Depuração ou use o atalho de teclado F5.
Quando o depurador pausar a execução no ponto de interrupção, passe o mouse sobre qualquer variável no escopo atual para abrir as dicas de dados.
Use a dica de dados para ver o nome da variável e trabalhar com o valor.
Conforme necessário, altere o valor de uma variável ou adicione comentários.
Observação
O Visual Studio avalia e exibe o valor da variável em uma dica de dados com base no contexto em que o depurador está pausado na execução. A avaliação não se baseia no local atual do cursor ou da dica de dados. Se você passar o mouse sobre uma variável em outra função com o mesmo nome de uma variável que esteja no contexto atual, o Visual Studio exibirá o valor da variável na dica de dados no contexto atual.
O Visual Studio dá suporte a muitas ações para as dicas de dados e o trabalho com variáveis e valores, incluindo:
- Fixar ou fazer flutuar uma dica de dados para mantê-la visível enquanto a execução do código continua
- Ativar as dicas de dados adesiva que permanecem expandidas até que você selecione outro lugar
- Expandir a dica de dados de uma matriz, estrutura ou objeto para exibir os membros dela em um formato de árvore
- Alterar o valor de uma variável em uma dica de dados
- Adicionar comentários de várias linhas a uma dica de dados fixada para fazer anotações durante a depuração
- Importar e exportar dados
Tornar as dicas de dados transparente
Ao passar o mouse sobre uma variável para exibir a dica de dados, você pode torná-la transparente para ver o código por baixo. Essa ação também ativa a transparência para outras ações de dica no editor de código, como as definições de método e a sintaxe de expressão.
Para habilitar a transparência, siga estas etapas:
No editor do Visual Studio Code, faça uma seleção dentro de uma dica de dados e, em seguida, selecione e segure Ctrl.
Para manter a transparência, continue pressionando Ctrl.
Para encerrar a transparência, pare de selecionar Ctrl ou selecione em outro lugar.
A transparência não está disponível para uma dica de dados fixada ou flutuante.
Manter dicas de dados expandida
No Visual Studio 2022 Atualização 1 e versões posteriores, quando você expandir uma dica de dados, poderá mantê-la expandida até selecionar em outro lugar. Essa ação produz uma dica de dados adesiva.
Para tornar uma dica de dados adesiva, siga estas etapas:
No Visual Studio, selecione Opções de>Depuração para abrir a caixa de diálogo Opções.
Na guia Geral, role para localizar a opção Manter dicas de dados expandidos abertas até serem clicadas.
Marque a caixa de seleção para ativar a opção adesiva e selecione OK.
Quando a opção adesiva está habilitada, se você expandir qualquer dica de dados no editor de código, ela permanecerá expandida.
Fixar dicas de dados
Você pode fixar uma dica de dados para mantê-la aberta na superfície do editor de código. Você também pode alterar o local da dica de dados fixada.
Para fixar uma dica de dados, siga estas etapas:
No editor do Visual Studio Code, passe o mouse sobre uma variável para mostrar a dica de dados.
Na dica de dados, use o alfinete para selecionar Fixar na origem:
O Visual Studio fixa a dica de dados em um local próximo à variável na superfície do código. Um alfinete aparecerá na medianiz do editor de código ao lado da linha onde você fixar a dica de dados.
Selecione e arraste a dica de dados fixada para qualquer local na superfície do editor de código.
Fazer flutuar (desafixar) as dicas de dados
Depois de fixar uma dica de dados, você pode desafixar a dica de dados e fazê-la flutuar. Uma dica de dados flutuante pode ser posicionada em qualquer lugar no IDE do Visual Studio.
Para fazer uma dica de dados flutuar, siga estas etapas:
Em uma dica de dados fixada, use o alfinete para selecionar Desafixar da origem.
O Visual Studio desafixa a dica de dados e dá à dica de dados um plano de fundo de cor sólida. O alfinete da dica de dados muda para a posição desafixada e o alfinete na medianiz do editor de código é removido.
Selecione e arraste a dica de dados flutuante para qualquer local no IDE do Visual Studio.
Se você posicionar a dica de dados flutuante fora da superfície do editor de código, o alfinete será removido do menu lateral da dica de dados. A opção Fixar na origem está disponível somente quando a dica de dados flutuante é posicionada na superfície do editor de código.
Fixar novamente dicas de dados
Depois de fazer flutuar uma dica de dados, você pode fixá-la novamente em um local de origem específico na superfície do editor de código.
Para fixar novamente uma dica de dados flutuante, siga estas etapas:
Selecione e mova a dica de dados flutuante e posicione-a na superfície do editor de código.
Na dica de dados flutuante, use o alfinete para selecionar Fixar na origem.
O alfinete é alterado para a posição fixada. A dica de dados é fixada novamente em um local específico no editor de código e um alfinete para a fonte aparece na medianiz do editor de código.
Fechar dicas de dados
Há várias maneiras de fechar as dicas de dados no Visual Studio.
Quando você encerra sua sessão de depuração, se tiver dicas de dados abertas, o Visual Studio as fecha para você. Se você iniciar outra sessão de depuração, o Visual Studio tentará restabelecer todas as dicas de dados que foram deixadas abertas anteriormente.
A tabela a seguir resume como você pode fechar manualmente as dicas de dados:
| Fechar destino | Ação |
|---|---|
| Dica de dados específica | Selecione X na dica de dados. |
| Todas as dicas de dados para um arquivo específico | Selecione Depurar>Limpar Todas as Dicas de Dados Fixadas em <Nome do Arquivo> na barra de ferramentas do Visual Studio. |
| Todas as dicas de dados abertas | Selecione Depurar>Limpar Todas as Dicas de Dados na barra de ferramentas do Visual Studio. |
Trabalhar com variáveis e valores em dicas de dados
Ao trabalhar com o recurso DataTips no Visual Studio, você obtém a capacidade de ver detalhes sobre as variáveis e os objetos e editar os valores durante a depuração. Esses recursos são úteis para a solução rápida de problemas e o teste de alterações em seu código.
Expandir objetos em dicas de dados para exibir membros
Quando uma dica de dados representa uma matriz, estrutura ou objeto, você pode expandir a exibição da dica de dados para ver os membros. A exibição expandida mostra as informações extras em um formato de árvore hierárquica.
Para expandir a exibição de um objeto em uma dica de dados, siga estas etapas:
Em uma dica de dados para uma matriz, estrutura ou objeto, selecione a seta de expansão antes do nome do item para mostrar os membros. A exibição é apresentada em um formato de árvore:
Para uma dica de dados fixada, selecione o símbolo de mais (+) antes do nome da variável para expandir a definição.
Continue selecionando as setas de expansão para exibir mais da hierarquia de membros:
Para mover para cima e para baixo no modo de exibição expandido, use o mouse ou as teclas de seta para cima e para baixo do teclado.
Para fixar um membro expandido com a dica de dados fixada original, use o alfinete no membro para selecionar Fixar na origem. Depois de recolher a exibição em árvore, todos os elementos de membro fixados permanecem visíveis com a dica de dados fixada.
Editar valores da variável
Outra vantagem de trabalhar com recurso DataTips é a capacidade de editar o valor de uma variável ou elemento em uma dica de dados durante a depuração. Essa funcionalidade é útil para testes rápidos de pequenas alterações feitas no código.
Para editar o valor de uma variável ou elemento em uma dica de dados, siga estas etapas:
Na dica de dados, selecione o valor. O Visual Studio destaca o valor e o disponibiliza para edição.
Insira um novo valor na dica de dados e selecione Enter.
Lembre-se de que alguns valores de variáveis são somente leitura. O Visual Studio não disponibiliza valores somente leitura para edição.
Usar comentários em dicas de dados
A região Comentários de uma dica de dados é útil para manter anotações sobre as variáveis à medida que você depura seu código. Essa região é um local conveniente para rastrear valores diferentes à medida que eles mudam durante a depuração. Você pode adicionar comentários em uma dica de dados fixada ou flutuante.
Para usar os Comentários em uma dica de dados, siga estas etapas:
Na dica de dados, use a seta dupla para baixo para selecionar Expandir para ver comentário. A seta dupla para baixo abre a região Comentários da dica de dados, onde você pode adicionar notas.
Para adicionar um comentário, insira o cursor na região Comentários e insira o texto. A região aceita várias linhas.
Para fechar a região Comentários, use a seta dupla para cima para Recolher comentários. Todos os comentários inseridos permanecerão na dica de dados, mas não estarão visíveis.
Fixar propriedades em dicas de dados
O Visual Studio dá suporte à fixação de propriedades nas dicas de dados fixadas no .NET Core 3.0 e posterior. Esse recurso permite inspecionar objetos rapidamente de acordo com suas propriedades nas dicas de dados.
Para fixar as propriedades nas dicas de dados, siga estas etapas:
Em uma dica de dados fixada, expanda a hierarquia de membros até ver uma propriedade que deseja manter visível na dica de dados.
Use o alfinete da propriedade para fixá-la na dica de dados. Você também pode clicar com o botão direito do mouse na propriedade e selecionar Fixar Membro como Favorito.
O Visual Studio move a propriedade selecionada para a parte superior da lista de propriedades do objeto. O nome e o valor da propriedade são exibidos na coluna direita da dica de dados fixada:
Para desafixar uma propriedade de uma dica de dados, selecione o alfinete da propriedade novamente ou clique com o botão direito do mouse na propriedade e selecione Desafixar Membro como Favorito.
Você também pode alternar a visibilidade das propriedades e filtrar propriedades não fixadas na lista de propriedades do objeto em uma dica de dados:
Para filtrar as propriedades desafixadas, clique com o botão direito do mouse na linha de propriedades na dica de dados e selecione Mostrar Somente Membros Fixados.
Para alternar a visibilidade dos nomes de propriedade, clique com o botão direito do mouse na linha de propriedade na dica de dados e selecione Ocultar Nomes de Membros Fixados em Valores.
A imagem a seguir mostra as várias opções no menu de clique com o botão direito do mouse para a hierarquia de membros em uma dica de dados:
Obter ajuda de IA
Caso tenha o Copilot, você pode obter assistência de IA enquanto analisa as variáveis nas dicas de dados. Clique com o botão direito do mouse em uma variável e use o botão Perguntar ao Copilot 
. Nesse cenário, o Copilot já sabe o contexto da pergunta, então você não precisa fornecê-lo no chat. Para obter mais informações, consulte Depurar com o Copilot.
Visualizar tipos de dados complexos
Os visualizadores exibem informações de maneira mais significativa e, às vezes, gráfica. Exemplos de visualizadores incluem XML, HTML, JSON e o Visualizador de Texto. Você pode usar as visualizações para examinar tipos de dados complexos em seu código durante a depuração.
Se os visualizadores estiverem disponíveis para um elemento, o Visual Studio exibirá a lupa Exibir ao lado do nome do elemento na dica de dados. Quando você seleciona uma visualização, o Visual Studio abre uma janela separada para exibir os dados complexos em um formato legível.
Você pode usar esse recurso para selecionar uma visualização para seus dados:
Para exibir o elemento usando o visualizador padrão para o tipo de dados, selecione a lupa.
Para selecionar um visualizador específico, expanda a lista suspensa Exibir ao lado da lupa e escolha uma opção.
Adicionar variáveis às janelas Inspeção
Você pode continuar a observar as variáveis adicionando-as a uma janela Inspeção do Visual Studio de uma dica de dados:
- Na dica de dados, clique com o botão direito do mouse no nome da variável e selecione Adicionar Inspeção.
O Visual Studio adiciona a variável na janela Inspeção. Se sua edição do Visual Studio der suporte a várias janelas Inspeção, a variável aparecerá na janela Inspeção 1.
Importar e exportar dados
Você pode exportar dicas de dados para um arquivo XML, que pode ser compartilhado ou editado usando-se um editor de texto. Você também pode importar as dicas de dados de um arquivo XML recebido ou editado anteriormente.
Para exportar as dicas de dados, siga estas etapas:
No Visual Studio, selecione Depurar>Exportar DataTips. A caixa de diálogo Exportar DataTips é aberta.
Na caixa de diálogo, procure o local em que você deseja salvar o arquivo XML.
Insira um nome para o arquivo de exportação e selecione Salvar.
O Visual Studio exporta suas dicas de dados para o arquivo e o local especificados.
Para importar as dicas de dados de um arquivo, siga estas etapas:
No Visual Studio, selecione Depurar>Importar DataTips. A caixa de diálogo Importar DataTips é aberta.
Na caixa de diálogo, procure o local do arquivo XML das dicas de dados a ser usado para a importação.
Selecione o arquivo para abrir e, em seguida, selecione Abrir.
O Visual Studio importa as dicas de dados do arquivo especificado para o workspace atual. Quando você depura o código do workspace, as dicas de dados importadas tornam-se disponíveis.