IDebugProperty2IDebugProperty2

Cette interface représente une propriété de frame de pile, une propriété de document du programme ou une autre propriété.This interface represents a stack frame property, a program document property, or some other property. La propriété est généralement le résultat d’une évaluation d’expression.The property is usually the result of an expression evaluation.

Note

Cette utilisation de « property » ne doit pas être confondue avec cette variable de membre d’une classe, ce qui signifie que même si un IDebugProperty2 peut représenter une telle entité.This use of "property" should not be confused with that meaning a member variable of a class, although an IDebugProperty2 can represent such an entity.

SyntaxeSyntax

IDebugProperty2 : IUnknown

Notes de publication pour les implémenteursNotes for Implementers

Le D’implémente cette interface pour représenter un type particulier de valeur.The DE implements this interface to represent a particular kind of value. Par exemple, la valeur peut être une valeur numérique à la suite d’une évaluation d’expression, un contexte de mémoire utilisé pour afficher la mémoire, ou une liste de registres et leurs valeurs.For example, the value could be a numerical value as a result of an expression evaluation, a memory context used for displaying memory, or a list of registers and their values.

Notes de publication pour les appelantsNotes for Callers

Appelez EvaluateSync ou EvaluateAsync pour obtenir cette interface, qui représente le résultat de l’évaluation.Call EvaluateSync or EvaluateAsync to obtain this interface, which represents the result of an evaluation. IDebugExpression2::EvaluateAsync Retourne cette interface en envoyant un IDebugExpressionEvaluationCompleteEvent2 interface pour le SDM, qui à son tour appelle GetResult pour récupérer la propriété.IDebugExpression2::EvaluateAsync returns this interface by sending an IDebugExpressionEvaluationCompleteEvent2 interface to the SDM, which in turn calls GetResult to retrieve the property.

  • GetDebugProperty retourne cette interface pour fournir le document de script associé.GetDebugProperty returns this interface to provide the associated script document.

  • GetReturnValue retourne cette interface pour représenter la valeur de retour d’une fonction.GetReturnValue returns this interface to represent the return value of a function.

  • GetDebugProperty retourne cette interface pour représenter les différentes propriétés du programme comme un nom ou un contexte de la mémoire.GetDebugProperty returns this interface to represent various properties of the program such as a name or a memory context.

  • GetDebugProperty retourne cette interface pour représenter les différentes propriétés du frame de pile tels que des variables locales.GetDebugProperty returns this interface to represent various properties of the stack frame such as local variables.

Méthodes dans l'ordre VtableMethods in Vtable Order

Le tableau suivant présente les méthodes de IDebugProperty2.The following table shows the methods of IDebugProperty2.

MéthodeMethod DescriptionDescription
GetPropertyInfoGetPropertyInfo Renseigne un DEBUG_PROPERTY_INFO structure qui décrit une propriété.Fills in a DEBUG_PROPERTY_INFO structure that describes a property.
SetValueAsStringSetValueAsString Définit la valeur d’une propriété à partir d’une chaîne.Sets the value of a property from a string.
SetValueAsReferenceSetValueAsReference Définit la valeur de la propriété à partir de la valeur d’une référence donnée.Sets the value of the property from the value of a given reference.
EnumChildrenEnumChildren Énumère les enfants d’une propriété.Enumerates the children of a property.
GetParentGetParent Retourne le parent d’une propriété.Returns the parent of a property.
GetDerivedMostPropertyGetDerivedMostProperty Retourne la propriété qui décrit la propriété la plus dérivée d’une propriété.Returns the property that describes the most-derived property of a property.
GetMemoryBytesGetMemoryBytes Retourne les octets de mémoire qui composent la valeur d’une propriété.Returns the memory bytes that compose the value of a property.
GetMemoryContextGetMemoryContext Retourne le contexte de la mémoire pour une valeur de propriété.Returns the memory context for a property value.
GetSizeGetSize Retourne la taille, en octets, de la valeur de propriété.Returns the size, in bytes, of the property value.
GetReferenceGetReference Retourne une référence à la valeur de cette propriété.Returns a reference to this property's value.
GetExtendedInfoGetExtendedInfo Retourne les informations étendues d’une propriété.Returns the extended information of a property.

NotesRemarks

Une propriété, telle que représentée par un IDebugProperty2 l’interface, peut être considéré comme une valeur avec un nom, un type et une adresse.A property, as represented by an IDebugProperty2 interface, can be thought of as a value with a name, a type, and an address. Dans des conditions plus générales, un IDebugProperty2 peut représenter tout ce qui a une structure hiérarchique, avec les parents et nœuds enfants.In more general terms, an IDebugProperty2 can represent anything that has a hierarchical structure, with parents and child nodes.

Une propriété est généralement transitoire, une durée d’uniquement tant que le frame de pile actuel, par exemple.A property is usually transitory, lasting only as long as the current stack frame, for example. En revanche, une référence, telle que représentée par un IDebugReference2 d’interface, est valable tant que la valeur reste en mémoire.On the other hand, a reference, as represented by an IDebugReference2 interface, lasts as long as the value remains in memory.

L’IDE peut utiliser le IDebugProperty2 interface pour permettre aux utilisateurs de parcourir et modifier les propriétés au moment de l’exécution.The IDE can use the IDebugProperty2 interface to let users browse and modify properties at run time.

Configuration requiseRequirements

En-tête : msdbg.hHeader: msdbg.h

Espace de noms : Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly : Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

Voir aussiSee also