IDebugProperty2
Cette interface représente une propriété du 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 de l'expression.
Notes
Cette utilisation de « propriété » ne doit pas être confondue avec cette signification une variable membre d'une classe, bien qu' IDebugProperty2 puisse représenter une telle entité.
IDebugProperty2 : IUnknown
Remarques à l'intention des 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 de l'expression, d'un contexte de mémoire utilisé pour restituer la mémoire, ou d'une liste de registres et de leurs valeurs.
Remarques pour les appelants
appelez IDebugExpression2 : : EvaluateSync ou IDebugExpression2 : : EvaluateAsync pour obtenir cette interface, qui représente le résultat d'une évaluation. IDebugExpression2::EvaluateAsync retourne cette interface en envoyant une interface d' IDebugExpressionEvaluationCompleteEvent2 au SDM, qui appelle ensuite IDebugExpressionEvaluationCompleteEvent2 : : GetResult pour récupérer la propriété.
IDebugPropertyCreateEvent2 : : GetDebugProperty retourne cette interface pour fournir le document associé de script.
IDebugReturnValueEvent2 : : GetReturnValue retourne cette interface pour représenter la valeur de retour d'une fonction.
IDebugProgram2 : : GetDebugProperty retourne cette interface pour représenter différentes propriétés du programme telles qu'un nom ou un contexte de mémoire.
IDebugStackFrame2 : : GetDebugProperty retourne cette interface pour représenter différentes propriétés du frame de pile telles que des variables locales.
méthodes en commande de Vtable
Le tableau suivant répertorie les méthodes d' IDebugProperty2.
Méthode |
Description |
|---|---|
Remplit une structure de DEBUG_PROPERTY_INFORMATION qui décrit une propriété. |
|
définit la valeur d'une propriété d'une chaîne. |
|
définit la valeur de la propriété de la valeur d'une référence donnée. |
|
énumère les enfants d'une propriété. |
|
Retourne le parent d'une propriété. |
|
Retourne la propriété qui décrit la propriété la plus dérivée d'une propriété. |
|
Retourne les octets de mémoire qui composent la valeur d'une propriété. |
|
Retourne le contexte de la mémoire pour une valeur de propriété. |
|
Retourne la taille, en octets, de la valeur de propriété. |
|
Retourne une référence à cette valeur de propriété. |
|
Retourne les informations détaillées d'une propriété. |
Notes
Une propriété, telle qu'elle est représentée par une interface d' IDebugProperty2 , peut être considérée comme valeur avec un nom, un type, et une adresse. En plus de spécifications générales, IDebugProperty2 peut représenter tout ce qui a une structure hiérarchique, avec des parents et des nœuds enfants.
Une propriété est généralement transitional, durant uniquement si le frame de pile actuel, par exemple. En revanche, une référence, telle qu'elle est représentée par une interface d' IDebugReference2 , en tant que la valeur reste dans la mémoire.
L'IDE peut utiliser l'interface d' IDebugProperty2 pour permettre aux utilisateurs de parcourir et modifier des propriétés au moment de l'exécution.
Configuration requise
en-tête : msdbg.h
l'espace de noms : Microsoft.VisualStudio.Debugger.Interop
Assembly : Microsoft.VisualStudio.Debugger.Interop.dll