Compartilhar via


Especificadores de formato em C# no depurador do Visual Studio

Use um especificador de formato para alterar o formato no qual um valor é exibido na janela Inspeção ao usar especificadores de formato. Você também pode usar especificadores de formato na janela Imediato, Comandoem tracepointse em janelas de fonte. Se você pausar em uma expressão nessas janelas, o resultado aparecerá em uma DataTip na exibição de formato especificado.

Para usar um especificador de formato, insira a expressão de variável seguida por uma vírgula e o especificador apropriado.

Definir especificadores de formato

Usaremos o seguinte código de exemplo:

{
    int my_var1 = 0x0065;
    int my_var2 = 0x0066;
    int my_var3 = 0x0067;
}

Adicione a my_var1variável à janela Inspeção durante a depuração, Depure> a Janela de>Inspeção>Watch 1. Em seguida, clique com o botão direito do mouse na variável e clique em Exibição Hexadecimal. Agora, a janela Inspeção mostra o valor 0x0065. Para ver esse valor como um inteiro decimal em vez de um inteiro hexadecimal, adicione o especificador de formato decimal , d na coluna Nome após o nome da variável. A coluna Valor agora mostra 101.

Screenshot of the Visual Studio Watch window with one line that shows my_var1, d with a value of 101 and a type of int.

Você pode exibir e selecionar em uma lista de especificadores de formato disponíveis acrescentando uma vírgula (,) ao valor na janela Inspeção.

FormatSpecCSharp

Especificadores de formato

A tabela a seguir descreve os especificadores de formato C# para o depurador do Visual Studio.

Especificador Formatar Valor original do relógio Telas
ac Force a avaliação de uma expressão, que pode ser útil quando a avaliação implícita de propriedades e chamadas de função implícita é desativada. Mensagem "A avaliação da função implícita foi desativada pelo usuário" <value>
d inteiro decimal 0x0065 101
dinâmico Exibe o objeto especificado usando um Modo de Exibição Dinâmico Exibe todos os membros do objeto, incluindo a Exibição Dinâmica Exibe apenas o Modo de Exibição Dinâmico
h inteiro hexadecimal 61541 0x0000F065
nq cadeia de caracteres sem aspas "Minha cadeia de caracteres" Minha cadeia de caracteres
nse Especifica o comportamento, não o formato. Avalia a expressão com "Sem efeitos colaterais". Se a expressão não puder ser interpretada e só puder ser resolvida por uma avaliação (como uma chamada de função), você verá um erro. N/D N/D
oculto Exibe todos os membros públicos e não públicos Exibe membros públicos Exibe todos os membros
raw Exibe o item como aparece no nó bruto do item. Válido apenas em objetos proxy. Dicionário<T> Exibição bruta do Dicionário<T>
results Usado com uma variável de tipo que implementa IEnumerable ou IEnumerable<T>, geralmente o resultado de uma expressão de consulta. Exibe apenas os membros que contém o resultado da consulta. Exibe todos os membros Exibe os membros que atendem às condições da consulta