Exibir valores de dados nas Dicas de Dados no editor de códigos
As dicas de dados fornecem um modo conveniente de consultar informações sobre variáveis em seu programa durante a depuração. As dicas de dados funcionam apenas no modo de interrupção e apenas com variáveis que estejam no escopo de execução atual. Se esta foi sua primeira tentativa de depurar um código, leia Depuração para iniciantes absolutos e Técnicas e ferramentas de depuração antes de continuar a ler este artigo.
Trabalhar com dicas de dados
As dicas de dados funcionam apenas no modo de interrupção e apenas nas variáveis que estejam no escopo de execução atual.
Exibir uma dica de dados
Defina um ponto de interrupção em seu código e inicie a depuração pressionando F5 ou selecionando Depurar>Iniciar Depuração.
Quando estiver em uma pausa no ponto de interrupção, passe o mouse sobre qualquer variável no escopo atual. Uma Dica de Dados será exibida, mostrando o nome e o valor atual das propriedades da variável.
Tornar uma dica de dados transparente
Para tornar uma dica de dados transparente para ver o código que está abaixo dela, enquanto estiver na dica de dados, pressione Ctrl. O DataTip permanecerá transparente enquanto você mantiver pressionada a tecla Ctrl. Isso não funciona para dicas de dados fixadas ou flutuantes.
Manter uma dica de dados expandida
A partir do Visual Studio 2022 Atualização 1, quando você expandir uma dica de dados, poderá mantê-la expandida até clicar em outro lugar. Isso é chamado de dica de dados autoadesiva. Para habilitar esse recurso, selecione Ferramentas>Opções>Depuração e, na guia Geral, selecione Manter as dicas de dados expandidas abertas até clicar fora delas.
Fixar uma dica de dados
Para fixar uma dica de dados para que ela permaneça aberta, selecione o pino Fixar no ícone de origem.
Você pode mover uma dica de dados fixada arrastando-a pela janela de código. Um ícone de pino aparece na sarjeta ao lado da linha à qual a dica de dados está fixada.
Observação
As dicas de dados são sempre avaliadas no contexto onde a execução é suspensa, e não a localização atual do cursor ou 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 está no contexto atual, será exibido o valor da variável no contexto atual.
Desafixar uma dica de dados da origem
Para deixar flutuante uma dica de dados fixada, passe o mouse sobre a dica de dados e selecione o ícone de pino no menu de contexto.
O ícone de pino muda para a posição desafixada e a dica de dados agora flutua ou pode ser arrastada acima de todas as janelas abertas. As dicas de dados flutuantes fecham quando a sessão de depuração termina.
Fixar uma dica de dados novamente
Para fixar novamente uma dica de dados flutuante na origem, passe o mouse sobre ela no editor de código e selecione o ícone de pino. O ícone de pino muda para a posição fixada e a dica de dados é novamente fixada somente na janela de código.
Se uma dica de dados estiver flutuando sobre uma janela de código não-fonte, o ícone de pino não estará disponível e a dica de dados não poderá ser fixada novamente. Para acessar o ícone de pino, retorne a dica de dados para a janela do editor de código arrastando-a ou dando foco à janela de código.
Fechar uma dica de dados
Para fechar uma dica de dados, passe o mouse sobre a dica de dados e selecione o ícone fechar (x) no menu de contexto.
Fechar todas as dicas de dados
Para fechar todas as dicas de dados, no menu Depurar, selecione Limpar Todas as dicas de dados.
Para fechar todos os DataTips para um arquivo específico
Para fechar todas as dicas de dados de um arquivo específico, no menu Depurar, selecione Limpar Todas as dicas de dados Fixadas no <Nome do Arquivo>.
Expandir e editar informações
Você pode usar as dicas de dados para expandir uma matriz, uma estrutura ou um objeto para exibir seus membros. Você também pode editar o valor de uma variável de uma dica de dados.
Expandir uma variável
Para expandir um objeto em uma dica de dados para ver seus elementos, passe o mouse sobre as setas de expansão antes dos nomes dos item para exibir os elementos na forma de árvore. Para uma dica de dados fixada, selecione o + antes do nome da variável e depois expanda a árvore.
Você pode usar o mouse ou as teclas de direção no teclado para se mover para cima e para baixo no modo de exibição expandido.
Você também pode fixar itens expandidos na dica de dados fixada passando o mouse sobre eles e selecionando seus ícones de pino. Os elementos aparecem na dica de dados fixada depois que a árvore é recolhida.
Editar o valor de uma variável
Para editar o valor de uma variável ou elemento em uma dica de dados, selecione o valor, digite um novo valor e pressione Enter. A seleção está desabilitada nos valores somente leitura.
Fixar propriedades em dicas de dados
Observação
Esse recurso é compatível com o .NET Core 3.0 ou superior.
Você pode inspecionar rapidamente objetos por suas propriedades nas dicas de dados com a ferramenta Propriedades Fixáveis. Para usar essa ferramenta, passe o mouse sobre uma propriedade e selecione o ícone de pino exibido ou clique com o botão direito do mouse e selecione a opção Fixar Membro como Favorito no menu de contexto resultante. Isso expande essa propriedade até a parte superior da lista de propriedades do objeto, e o nome e o valor da propriedade são exibidos na coluna direita da dica de dados. Para desafixar uma propriedade, selecione o ícone de pino novamente ou selecione a opção Desafixar Membro como Favorito no menu de contexto.
Você também pode alternar entre os nomes das propriedades e filtrar propriedades não fixadas ao exibir a lista de propriedades do objeto em uma dica de dados. Você pode acessar qualquer uma das opções clicando com o botão direito do mouse em uma linha que contém uma propriedade e selecionando as opções Mostrar somente membros fixados ou Ocultar nomes de membros fixados nos valores no menu de contexto.
Visualizar tipos de dados complexos
Um ícone de lupa ao lado de uma variável ou elemento em uma dica de dados significa que um ou mais visualizadores, como o Visualizador de Texto, estão disponíveis para a variável. Os visualizadores exibem informações de maneira mais significativa, às vezes gráfica.
Para exibir o elemento usando o visualizador padrão para o tipo de dados, selecione o ícone de lupa 
. Selecione a seta ao lado do ícone de lupa para selecionar o tipo de dados em uma lista de visualizadores.
Adicionar uma variável à Janela Inspeção
Se você quiser continuar a inspecionar uma variável, poderá adicionar a variável à janela Inspeção de uma dica de dados. Clique com o botão direito do mouse na variável da dica de dados e selecione Adicionar Inspeção.
A variável aparece na janela Inspeção. Se sua edição do Visual Studio der suporte a mais de uma janela Inspeção, a variável aparecerá no Watch 1.
Importar e exportar dados
Você pode exportar dicas de dados para um arquivo XM, o qual você pode compartilhar ou editar usando um editor de texto. Você também pode importar um arquivo XML da dica de dados que recebeu ou editou.
Para exportar dicas de dados:
Selecione Depurar>Exportar DataTips.
Na caixa de diálogo Exportar DataTips, navegue até o local para salvar o arquivo XML, digite um nome para o arquivo e depois selecione Salvar.
Para importar dicas de dados:
Selecione Depurar>Importar DataTips.
Na caixa de diálogo Importar dicas de dados, selecione o arquivo XML das dicas de dados que você deseja abrir e, em seguida, selecione Abrir.
Conteúdo relacionado
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de