Pseudo-variables

Article
06/10/2015

Les pseudo-variables sont des termes utilisés pour afficher certaines informations dans une fenêtre de variable ou dans la boîte de dialogue Espion express. Vous pouvez entrer une pseudo-variable de la même façon qu'une variable normale. Toutefois, les pseudo-variables ne sont pas des variables et ne correspondent pas à des noms de variable de votre programme.

Exemple

Supposez que vous écrivez une application en code natif et que vous voulez afficher le nombre de handles alloués à votre application. Dans la fenêtre Espion, entrez la pseudo-variable suivante dans la colonne Nom, puis appuyez sur Entrée pour l'évaluer :

$handles

En code natif, vous pouvez utiliser les pseudo-variables indiquées dans le tableau suivant :

Pseudo-variable	Fonction
$err	Affiche la dernière valeur d'erreur définie avec la fonction SetLastError. La valeur affichée représente la valeur retournée par la fonction GetLastError. Utilisez $err,hr pour afficher cette valeur sous une forme décodée. Par exemple, si la dernière erreur est 3, $err,hr affiche ERROR_PATH_NOT_FOUND : The system cannot find the path specified.
$handles	Affiche le nombre de handles alloués à votre application.
$vframe	Affiche l'adresse du frame de pile actuel.
$tid	Affiche l'ID du thread actuel.
$env	Affiche le bloc environnement de l'explorateur de chaînes.
$cmdline	Affiche la chaîne de ligne de commande qui a lancé le programme.
$pid	Affiche l'ID du processus.
$registername ou @registername	Affiche le contenu du registre registername. En règle générale, vous pouvez afficher le contenu du registre en entrant simplement son nom. Vous n'avez besoin d'utiliser cette syntaxe que lorsque le nom de registre surcharge le nom d'une variable. Si le nom de registre est le même que celui d'une variable dans la portée actuelle, le débogueur interprète le nom comme étant celui de la variable. Vous pouvez alors utiliser $registername ou @registername.
$clk	Affiche le temps en cycles d'horloge.
$user	Affiche une structure avec les informations du compte qui exécute l'application. Pour des raisons de sécurité, les informations de mot de passe ne sont pas affichées.
$exceptionstack	Affiche l'arborescence des appels de procédure de l'exception Windows Runtime actuelle. $ exceptionstack ne fonctionne que dans les applications Windows Store s'exécutant dans Windows 8.1 ou version ultérieure. $ exceptionstack n'est pas pris en charge pour les exceptions C++ et SHE
$ReturnValue	Affiche la valeur de retour d'une méthode .NET Framework. Consultez Examiner les valeurs de retour d'appels de méthode.

En C# et Visual Basic, vous pouvez utiliser les pseudo-variables indiquées dans le tableau suivant :

Pseudo-variable	Fonction
$exception	Affiche des informations sur la dernière exception. Si aucune exception ne s'est produite, l'évaluation de $exception affiche un message d'erreur. En Visual C# uniquement, quand l'Assistant Exception est désactivé, $exception est automatiquement ajouté à la fenêtre Variables locales quand une exception se produit.
$user	Affiche une structure avec les informations du compte qui exécute l'application. Pour des raisons de sécurité, les informations de mot de passe ne sont pas affichées.

$exception

Affiche des informations sur la dernière exception. Si aucune exception ne s'est produite, l'évaluation de $exception affiche un message d'erreur.

En Visual C# uniquement, quand l'Assistant Exception est désactivé, $exception est automatiquement ajouté à la fenêtre Variables locales quand une exception se produit.

$user

Affiche une structure avec les informations du compte qui exécute l'application. Pour des raisons de sécurité, les informations de mot de passe ne sont pas affichées.

En Visual Basic, vous pouvez utiliser les pseudo-variables indiquées dans le tableau suivant :

Pseudo-variable	Fonction
$delete ou $$delete	Supprime une variable implicite créée dans la fenêtre Exécution. La syntaxe est $delete, variable ou $delete, variable.
$objectids ou $listobjectids	Affiche tous les ID d'objet actifs en tant qu'enfants de l'expression spécifiée. La syntaxe est $objectid, expression ou $listobjectids, expression.
$N#	Affiche l'objet dont l'ID d'objet est égal à N.
$dynamic	Affiche le nœud spécial Affichage dynamique pour un objet qui implémente le IDynamicMetaObjectProvider. Interface. La syntaxe est $dynamic, objet. Cette fonctionnalité s'applique uniquement au code utilisant .NET Framework version 4. Consultez Affichage dynamique.

Pseudo-variables

Exemple

Voir aussi

Tâches

Autres ressources

Ressources supplémentaires