IDebugProperty2IDebugProperty2

Esta interfaz representa una propiedad de marco de pila, una propiedad de documento del programa o alguna otra propiedad.This interface represents a stack frame property, a program document property, or some other property. La propiedad suele ser el resultado de evaluación de una expresión.The property is usually the result of an expression evaluation.

Note

Este uso de "propiedad" no debe confundirse con la que lo que significa que una variable de miembro de una clase, aunque un IDebugProperty2 puede representar dicha entidad.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.

SintaxisSyntax

IDebugProperty2 : IUnknown

Notas para los implementadoresNotes for Implementers

La DE implementa esta interfaz para representar un determinado tipo de valor.The DE implements this interface to represent a particular kind of value. Por ejemplo, el valor podría ser un valor numérico como resultado de evaluación de una expresión, un contexto de la memoria utilizada para mostrar la memoria o una lista de registros y sus valores.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.

Notas para los llamadoresNotes for Callers

Llame a EvaluateSync o EvaluateAsync para obtener esta interfaz, que representa el resultado de una evaluación.Call EvaluateSync or EvaluateAsync to obtain this interface, which represents the result of an evaluation. IDebugExpression2::EvaluateAsync devuelve esta interfaz mediante el envío de un IDebugExpressionEvaluationCompleteEvent2 interfaz para el SDM, que a su vez llama a GetResult para recuperar la propiedad.IDebugExpression2::EvaluateAsync returns this interface by sending an IDebugExpressionEvaluationCompleteEvent2 interface to the SDM, which in turn calls GetResult to retrieve the property.

  • GetDebugProperty devuelve esta interfaz para proporcionar el documento de script asociado.GetDebugProperty returns this interface to provide the associated script document.

  • GetReturnValue devuelve esta interfaz para representar el valor devuelto de una función.GetReturnValue returns this interface to represent the return value of a function.

  • GetDebugProperty devuelve esta interfaz para representar distintas propiedades del programa como un nombre o en un contexto de la memoria.GetDebugProperty returns this interface to represent various properties of the program such as a name or a memory context.

  • GetDebugProperty devuelve esta interfaz para representar distintas propiedades del marco de pila como variables locales.GetDebugProperty returns this interface to represent various properties of the stack frame such as local variables.

Métodos en orden de VtableMethods in Vtable Order

La tabla siguiente muestran los métodos de IDebugProperty2.The following table shows the methods of IDebugProperty2.

MétodoMethod DescripciónDescription
GetPropertyInfoGetPropertyInfo Rellena un DEBUG_PROPERTY_INFO estructura que describe una propiedad.Fills in a DEBUG_PROPERTY_INFO structure that describes a property.
SetValueAsStringSetValueAsString Establece el valor de una propiedad de una cadena.Sets the value of a property from a string.
SetValueAsReferenceSetValueAsReference Establece el valor de la propiedad del valor de una referencia especificada.Sets the value of the property from the value of a given reference.
EnumChildrenEnumChildren Enumera a los elementos secundarios de una propiedad.Enumerates the children of a property.
GetParentGetParent Devuelve al elemento primario de una propiedad.Returns the parent of a property.
GetDerivedMostPropertyGetDerivedMostProperty Devuelve la propiedad que describe la propiedad más derivado de una propiedad.Returns the property that describes the most-derived property of a property.
GetMemoryBytesGetMemoryBytes Devuelve los bytes de memoria que componen el valor de una propiedad.Returns the memory bytes that compose the value of a property.
GetMemoryContextGetMemoryContext Devuelve el contexto de la memoria para un valor de propiedad.Returns the memory context for a property value.
GetSizeGetSize Devuelve el tamaño, en bytes, del valor de propiedad.Returns the size, in bytes, of the property value.
GetReferenceGetReference Devuelve una referencia al valor de esta propiedad.Returns a reference to this property's value.
GetExtendedInfoGetExtendedInfo Devuelve la información extendida de una propiedad.Returns the extended information of a property.

ComentariosRemarks

Una propiedad, tal como está representada por un IDebugProperty2 de la interfaz, puede considerarse como un valor con un nombre, un tipo y una dirección.A property, as represented by an IDebugProperty2 interface, can be thought of as a value with a name, a type, and an address. En términos más generales, un IDebugProperty2 puede representar cualquier cosa que tiene una estructura jerárquica, con elementos primarios y nodos secundarios.In more general terms, an IDebugProperty2 can represent anything that has a hierarchical structure, with parents and child nodes.

Una propiedad es normalmente transitoria, sólo que duran como marco de pila actual, por ejemplo.A property is usually transitory, lasting only as long as the current stack frame, for example. Por otro lado, una referencia, tal como está representada por un IDebugReference2 interfaz dura siempre y cuando el valor permanece en memoria.On the other hand, a reference, as represented by an IDebugReference2 interface, lasts as long as the value remains in memory.

El IDE puede usar el IDebugProperty2 interfaz para permitir que los usuarios examinar y modificar las propiedades en tiempo de ejecución.The IDE can use the IDebugProperty2 interface to let users browse and modify properties at run time.

RequisitosRequirements

Encabezado: msdbg.hHeader: msdbg.h

Espacio de nombres: Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

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

Vea tambiénSee also