Partager via


IDebugProperty2

Cette interface représente une propriété frame de pile, une propriété de document de programme ou une autre propriété. La propriété est généralement le résultat d’une évaluation d’expression.

Remarque

Cette utilisation de « propriété » ne doit pas être confondue avec cette signification, ce qui signifie qu’une variable membre d’une classe, bien qu’une IDebugProperty2 entité puisse représenter une telle entité.

Syntaxe

IDebugProperty2 : IUnknown

Remarques pour les implémenteurs

Le DE implémente cette interface pour représenter un type particulier de valeur. Par exemple, la valeur peut être une valeur numérique à la suite d’une évaluation d’expression, d’un contexte de mémoire utilisé pour l’affichage de la mémoire ou d’une liste de registres et de leurs valeurs.

Remarques pour les appelants

Appelez EvaluateSync ou EvaluateAsync pour obtenir cette interface, qui représente le résultat d’une évaluation. IDebugExpression2::EvaluateAsync retourne cette interface en envoyant une interface IDebugExpressionEvaluationCompleteEvent2 à la SDM, qui appelle à son tour GetResult pour récupérer la propriété.

  • GetDebugProperty retourne cette interface pour fournir le document de script associé.

  • GetReturnValue retourne cette interface pour représenter la valeur de retour d’une fonction.

  • GetDebugProperty retourne cette interface pour représenter différentes propriétés du programme, telles qu’un nom ou un contexte de mémoire.

  • GetDebugProperty retourne cette interface pour représenter différentes propriétés de la trame de pile, telles que les variables locales.

Méthodes dans l'ordre Vtable

Le tableau suivant présente les méthodes de IDebugProperty2.

Méthode Description
GetPropertyInfo Renseigne une structure DEBUG_PROPERTY_INFO qui décrit une propriété.
SetValueAsString Définit la valeur d’une propriété à partir d’une chaîne.
SetValueAsReference Définit la valeur de la propriété à partir de la valeur d’une référence donnée.
EnumChildren Énumère les enfants d’une propriété.
GetParent Retourne le parent d’une propriété.
GetDerivedMostProperty Retourne la propriété qui décrit la propriété la plus dérivée d’une propriété.
GetMemoryBytes Retourne les octets de mémoire qui composent la valeur d’une propriété.
GetMemoryContext Retourne le contexte de mémoire d’une valeur de propriété.
GetSize Retourne la taille, en octets, de la valeur de la propriété.
GetReference Retourne une référence à la valeur de cette propriété.
GetExtendedInfo Retourne les informations étendues d’une propriété.

Notes

Une propriété, telle qu’elle est représentée par une IDebugProperty2 interface, peut être considérée comme une valeur avec un nom, un type et une adresse. En termes plus généraux, un IDebugProperty2 peut représenter tout ce qui a une structure hiérarchique, avec les parents et les nœuds enfants.

Une propriété est généralement transitoire, durable uniquement tant que le cadre de pile actuel, par exemple. En revanche, une référence, telle qu’elle est représentée par une interface IDebugReference2 , dure tant que la valeur reste en mémoire.

L’IDE peut utiliser l’interface IDebugProperty2 pour permettre aux utilisateurs de parcourir et de modifier les propriétés au moment de l’exécution.

Spécifications

En-tête : msdbg.h

Espace de noms : Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dll

Voir aussi