Pseudo-variables dans le débogueur Visual Studio

  • Article

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 de 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 fonctionne uniquement dans les applications UWP. $ exceptionstack n’est pas pris en charge pour les exceptions C++ et SEH
$returnvalue Affiche la valeur renvoyée d’une méthode.

En C#, 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.

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.
$returnvalue Affiche la valeur renvoyée d’une méthode .NET.
$threadSmallObjectHeapBytes Affiche le nombre total d’octets alloués dans le segment de mémoire de petits objets par le thread actuel. (.NET 6+)
$threadUserOldHeapBytes Affiche le nombre total d’octets alloués dans l’ancien tas utilisateur par le thread actuel. User Old Heap = Large Object Heap + Pinned Object Heap (.NET 6+)

En 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.
$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 ou ultérieure.

Contenu connexe