Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo explora como trabalhar com o recurso de dicas de dados no Visual Studio. As dicas de dados fornecem uma maneira conveniente de exibir informações sobre variáveis em seu programa enquanto você depura seu código. Quando definiste breakpoints no teu código e iniciaste o debug, as sugestões de dados ficam visíveis para variáveis à medida que entram no escopo atual de execução. Você pode usar o indicador 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 és novo em depuração, talvez queiras ler Depuração para iniciantes absolutas e técnicas de depuração e ferramentas antes de trabalhares neste artigo.
Pré-requisitos
Visual Studio. Se você não tiver o Visual Studio, vá para a página de downloads do Visual Studio para instalá-lo gratuitamente.
Algum código de programa para executar no depurador do Visual Studio.
Trabalhar com dicas sobre dados
As dicas de dados ficam visíveis durante uma sessão de debug quando tens pontos de paragem definidos no teu código. Quando o depurador pausa a execução do programa em um ponto de paragem, as dicas de dados estão disponíveis para todas as variáveis no escopo atual.
A partir do Visual Studio 2022 versão 17.14, você também pode exibir dicas de dados para expressões LINQ.
Aqui está o processo:
Defina um ponto de interrupção no seu código e inicie a depuração selecionando Depurar>Iniciar a Depuração ou use o atalho de teclado F5.
Quando o depurador pausa a execução no ponto de interrupção, passe o mouse sobre qualquer variável no escopo atual para abrir a dica 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 numa informação de dados com base no contexto em que o depurador está pausado durante a execução. A avaliação não se baseia na localização atual do cursor ou da dica de dados. Se passares o cursor sobre uma variável em outra função que tenha o mesmo nome de uma variável no contexto atual, o Visual Studio mostrará o valor da variável no balão de dados para o contexto atual.
Visual Studio oferece suporte a muitas ações para dicas de dados e para o trabalho com variáveis e valores, incluindo:
- Fixe ou deixe flutuar uma dica de dados para mantê-la visível enquanto o código é executado.
- Torne as dicas de informações transparentes
- Ative dicas de dados adesivas que permanecem expandidas até que selecione outro local
- Expanda a dica de dados de uma matriz, estrutura ou objeto para ver os seus membros em formato de árvore
- Alterar o valor de uma variável numa sugestão de dados
- Adicionar comentários de várias linhas a uma dica de dados afixada para tomar notas durante a depuração
- Dicas de importação e exportação de dados
Torne as dicas de informações transparentes
Ao passar o mouse sobre uma variável para exibir a dica de dados, você pode torná-la transparente para ver o código abaixo. Essa ação também ativa a transparência para outras ações de dica no editor de código, como definições de método e sintaxe de expressão.
Para habilitar a transparência, siga estas etapas:
No editor Visual Studio Code, selecione dentro de uma indicação de dados e, em seguida, mantenha a tecla Ctrl pressionada.
Para manter a transparência, mantenha pressionada a tecla Ctrl.
Para encerrar a transparência, deixe de pressionar Ctrl ou faça a seleção noutro lugar.
A transparência não está disponível para uma dica de dados fixada ou flutuante.
Mantenha as dicas de dados expandidas
No Visual Studio 2022 Atualização 1 e posterior, quando você expande uma dica de dados, pode mantê-la expandida até selecionar outro lugar. Esta ação produz uma dica de dados pegajosa.
Para tornar uma dica de dados adesiva, siga estas etapas:
No Visual Studio, selecione Depurar>Opções para abrir a caixa de diálogo Opções.
No separador Geral, desloque-se para encontrar a opção Manter as sugestões de dados expandidos abertas até clicar fora.
Marque a caixa de seleção para ativar a opção adesiva e selecione OK.
Quando a opção fixa está ativada, se expandires qualquer dica de dados no editor de código, ela permanecerá expandida.
Dicas de fixação 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 a posição da dica de dados fixada.
Para fixar uma dica de dados, siga estas etapas:
No editor de código do Visual Studio Code, coloque o cursor sobre uma variável para exibir a informação da variável.
Na dica de dados, use o pin para selecionar Afixar na origem:
O Visual Studio fixa a informação perto da variável na superfície do código. Um alfinete aparece na margem do editor de código ao lado da linha onde tu prendes a dica de dados.
Selecione e arraste a dica de dados fixada para qualquer local na área do editor de código.
Dicas de dados de flutuação (desafixar)
Depois de fixar uma dica de dados, você pode desafixar a dica de dados e torná-la flutuar. Uma tooltip flutuante pode ser posicionada em qualquer lugar no ambiente do Visual Studio IDE.
Para exibir uma dica de dados, siga estas etapas:
Numa dica de dados fixada, use o alfinete para selecionar Desafixar da origem.
O Visual Studio desafixa a dica de dados e dá-lhe um plano de fundo de cor sólida. O pino da ponta de dados muda para a posição não fixada e o pino na calha do editor de código é removido.
Selecione e arraste a dica flutuante para qualquer local no IDE do Visual Studio.
Se posicionares a ponta de dados flutuante fora da superfície do editor de código, o pino será removido do menu lateral da ponta de dados. A opção Pin to source está disponível somente quando a ponta de dados flutuante está posicionada na superfície do editor de código.
Dicas de dados para Repin
Depois de fixar temporariamente uma dica de dados, podes fixá-la novamente em um local de origem específico na área de edição de código.
Para repor uma dica de dados flutuantes, siga estas etapas:
Selecione e mova a ponta de dados flutuante e posicione-a na superfície do editor de código.
Na dica de dados flutuantes, use o pushpin para selecionar Fixar à origem.
O pino muda para a posição fixada. A dica de dados é fixada novamente num local específico no editor de código, e um alfinete para o código fonte aparece na margem do editor de código.
Fechar dicas de dados
Há várias maneiras de fechar dicas de dados no Visual Studio.
Quando você termina sua sessão de depuração, se você tiver dicas de dados abertos, o Visual Studio as fechará para você. Se iniciar outra sessão de depuração, o Visual Studio tentará restabelecer todas as informações de dados que deixou abertas anteriormente.
A tabela a seguir resume como pode fechar manualmente as informações detalhadas.
| Fechar alvo | Ação |
|---|---|
| Dica específica de dados | Selecione o X na informação de dados. |
| Todas as dicas de dados para um arquivo específico | Selecione Depurar>Limpar Todas as Dicas de Dados Afixadas ao Nome do Ficheiro <> na barra de ferramentas do Visual Studio. |
| Todas as dicas de dados abertos | Selecione Depurar>Clear All DataTips na barra de ferramentas do Visual Studio. |
Trabalhar com variáveis e valores em dicas de dados
Ao trabalhar com dicas de dados no Visual Studio, obtém-se a capacidade de ver detalhes sobre variáveis e objetos, além de editar valores durante a depuração. Esses recursos são úteis para solucionar problemas rápidos e testar alterações em seu código.
Expandir objetos nos detalhes de dados para exibir membros
Quando uma dica de dados representa uma matriz, estrutura ou objeto, pode-se expandir a exibição da dica de dados para ver os membros. O modo de exibição expandido 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 vista é apresentada em formato de árvore:
Para uma dica de dados fixada, selecione o símbolo de adição (+) antes do nome da variável para expandir a definição.
Continue a selecionar as setas de expansão para ver mais da hierarquia de membros:
Para mover para cima e para baixo na vista expandida, utilize o rato ou as teclas de seta para cima e para baixo no teclado.
Para fixar um membro expandido juntamente com a dica de dados original fixada, use o ícone de pin no membro para selecionar Fixar na origem. Depois de recolher a vista em árvore, todos os elementos de membro fixados permanecem visíveis com a dica de dados fixos.
Editar valores de variáveis
Outra vantagem de trabalhar com dicas contextuais é a capacidade de editar o valor de uma variável ou elemento em uma dica contextual durante a depuração. Essa funcionalidade é útil para testes rápidos de pequenas alterações no seu código.
Para editar o valor de uma variável ou elemento numa dica de dados, siga estas etapas:
No apontador de dados, selecione o valor. O Visual Studio destaca o valor e o disponibiliza para edição.
Insira um novo valor no tooltip e selecione Enter.
Tenha em mente que alguns valores de variáveis são apenas de leitura. O Visual Studio não permite a edição de valores de leitura única.
Utilizar comentários em dicas de dados
A região Comentários de uma dica de dados é útil para manter anotações sobre variáveis enquanto você depura seu código. Essa região é um lugar conveniente para rastrear valores diferentes à medida que eles mudam durante a depuração. Você pode adicionar comentários em uma dica de dados fixa ou flutuante.
Para usar 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 o comentário. A seta dupla descendente abre a região de Comentários da dica de dados onde pode adicionar anotações.
Para adicionar um comentário, insira o cursor na região Comentários e insira texto. A região aceita várias linhas.
Para fechar a região Comentários, use a seta dupla para cima para Fechar comentários. Todos os comentários inseridos permanecem com a sugestão de dados, mas atualmente não estão visíveis.
Fixar propriedades em dicas de dados
O Visual Studio oferece suporte para fixar propriedades em dicas fixas de dados no .NET Core 3.0 e posterior. Esta funcionalidade permite-lhe inspecionar rapidamente objetos através das suas propriedades nas sugestões de dados.
Para fixar propriedades em sugestões de dados, siga estas etapas:
Em uma dica de dados afixada, expanda a hierarquia de membros até encontrar uma propriedade que deseje manter visível na dica de dados.
Use o alfinete da propriedade para fixá-la com a dica de dados. Você também pode clicar com o botão direito do mouse na propriedade e selecionar Fixar Membro como Favorito.
Visual Studio move a propriedade selecionada para o topo da lista de propriedades do objeto. O nome da propriedade e o valor são exibidos na coluna direita do tooltip fixo.
Para remover uma propriedade numa dica de dados, selecione novamente o pino da propriedade ou clique com o botão direito na propriedade e selecione Remover Membro como Favorito.
Você também pode alternar a visibilidade dos nomes das propriedades e filtrar as propriedades desmarcadas na lista de propriedades do objeto em uma dica de informação.
Para filtrar propriedades não fixadas, clique com o botão direito do mouse na linha de propriedades na dica de dados e selecione Mostrar Somente Membros Fixos .
Para alternar a visibilidade de 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 fixos em Valores.
A imagem a seguir mostra as várias opções no menu do botão direito do rato para a hierarquia de membros num apontador de dados:
Obtenha assistência de IA
Se tiver o Copilot, poderá obter assistência de IA enquanto analisa variáveis nas dicas sobre dados. Clique com o botão direito do rato em uma variável e use o Ask Copilot
botão. Nesse cenário, o Copilot já conhece o contexto da sua pergunta, então você não precisa fornecer contexto no bate-papo. Para obter mais informações, consulte Debug with Copilot.
A partir do Visual Studio 2022 versão 17.14, é possível obter assistência do Copilot através de dicas de dados para expressões LINQ.
Visualize tipos de dados complexos
Os visualizadores exibem informações de uma maneira mais significativa e, às vezes, gráfica. Exemplos de visualizadores incluem XML, HTML, JSON, Text Visualizer e os visualizadores tabulares. Você pode usar 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á o ícone Ver ao lado do nome do elemento na dica de ferramentas. 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 Ver e escolha uma opção ao lado da lupa.
Adicionar variáveis às janelas de observação
Você pode continuar a observar variáveis adicionando-as a uma janela do Visual Studio Watch a partir 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 Observação.
O Visual Studio adiciona a variável na janela Watch. Se sua edição do Visual Studio oferecer suporte a várias janelas Watch, a variável aparecerá na janela rotulada Watch 1.
Dicas de importação e exportação de dados
Você pode exportar dicas de dados para um arquivo XML, que pode ser compartilhado ou editado usando um editor de texto. Você também pode importar dicas de dados de um arquivo XML recebido ou editado anteriormente.
Para exportar sugestões de dados, siga estas etapas:
No Visual Studio, selecione Depurar>Exportar Dicas de Dados. A caixa de diálogo Exportar Dicas de Dados é aberta.
Na caixa de diálogo, navegue até o local onde deseja salvar o arquivo XML.
Insira um nome para o arquivo de exportação e selecione Salvar.
O Visual Studio exporta as suas dicas de dados para o arquivo e o local especificados.
Para importar sugestões de dados de um arquivo, siga estes passos:
No Visual Studio, selecione Depurar>Importar Dicas de Dados. A caixa de diálogo Importar Dicas de Dados é aberta.
Na caixa de diálogo, navegue até à localização do ficheiro XML de dicas sobre os dados para usar na importação.
Selecione o arquivo a ser aberto e selecione Abrir.
O Visual Studio importa as dicas de dados do arquivo especificado para o seu espaço de trabalho atual. Ao depurares o código do ambiente de trabalho, as dicas de dados importados ficam disponíveis.