Partilhar via

Pseudovariáveis no depurador do Visual Studio

Pseudovariáveis são termos usados para exibir determinadas informações em uma janela variável ou na caixa de diálogo QuickWatch . Você pode inserir uma pseudovariável da mesma forma que inseriria uma variável normal. Pseudovariáveis não são variáveis, no entanto, e não correspondem a nomes de variáveis em seu programa.

Example

Suponha que estejas a escrever uma aplicação de código nativo e queiras ver o número de handles alocados na tua aplicação. Na janela Inspeção , você pode inserir a seguinte pseudovariável na coluna Nome e pressionar Return para avaliá-la:

$handles

No código nativo, você pode usar as pseudovariáveis mostradas na tabela a seguir:

Pseudovariável Função
$err Exibe o último valor de erro definido com a função SetLastError. O valor exibido representa o que seria retornado pela função GetLastError.

Use $err,hr para ver a forma decodificada desse valor. Por exemplo, se o último erro foi 3, o $err,hr exibiria ERROR_PATH_NOT_FOUND : The system cannot find the path specified.
$handles Exibe o número de 'handles' alocados na sua aplicação.
$vframe Exibe o endereço do quadro de pilha atual.
$tid Exibe o ID do thread para o thread atual.
$env Exibe o bloco de ambiente no visualizador de cadeia de caracteres.
$cmdline Exibe a cadeia de caracteres de linha de comando que iniciou o programa.
$pid Exibe a ID do processo.
$ nome do registo

ou

@ nome do registo		 Exibe o conteúdo do nome de registro do registro.

Normalmente, você pode exibir o conteúdo do registro apenas digitando o nome do registro. O único momento em que você precisa usar essa sintaxe é quando o nome do registro sobrecarrega um nome de variável. Se o nome do registro for o mesmo que um nome de variável no escopo atual, o depurador interpretará o nome como um nome de variável. É aí $ que registername ou @registername vem a calhar.
$clk Exibe a hora em ciclos de relógio.
$user Exibe uma estrutura com informações de conta para a conta que executa o aplicativo. Por motivos de segurança, as informações de senha não são exibidas.
$exceptionstack Exibe o rastreamento de pilha da exceção atual do Tempo de Execução do Windows. $ exceptionstack funciona apenas em aplicativos UWP. $ exceptionstack não tem suporte para exceções de C++ e SEH
$returnvalue Exibe o valor de retorno de um método.

Em C# você pode usar as pseudovariáveis mostradas na tabela a seguir:

Pseudovariável Função
$exception Exibe informações sobre a última exceção. Se nenhuma exceção tiver ocorrido, a avaliação $exception exibirá uma mensagem de erro.

Quando o Assistente de Exceção está desativado, $exception é adicionado automaticamente à janela Locais quando ocorre uma exceção.
$user Exibe uma estrutura com informações de conta para a conta que executa o aplicativo. Por motivos de segurança, as informações de senha não são exibidas.
$returnvalue Exibe o valor de retorno de um método .NET.
$threadSmallObjectHeapBytes Exibe o número total de bytes alocados no heap de objetos pequenos pela thread atual. (.NET 6+)
$threadUserOldHeapBytes Exibe o número total de bytes alocados no heap antigo do usuário pelo thread atual. User Old Heap = Large Object Heap + Pinned Object Heap (.NET 6+)

No Visual Basic, você pode usar as pseudovariáveis mostradas na tabela a seguir:

Pseudovariável Função
$exception Exibe informações sobre a última exceção. Se nenhuma exceção tiver ocorrido, a avaliação $exception exibirá uma mensagem de erro.
$delete ou $$delete Exclui uma variável implícita que foi criada na janela Immediate . A sintaxe é $delete,variável ou$delete,variável.
$objectids ou $listobjectids Exibe todas as IDs de objeto ativas como filhos da expressão especificada. A sintaxe é $objectid,expressão ou$listobjectids,expressão.
$ N# Exibe o objeto com ID de objeto igual a N.
$dynamic Exibe o nó especial de Exibição Dinâmica para um objeto que implementa o IDynamicMetaObjectProvider. Interface. A sintaxe é $dynamic,objeto. Esse recurso se aplica somente ao código que usa o .NET Framework versão 4 ou posterior.

Conteúdo relacionado

  • Last updated on