Поделиться через


IDebugProperty2

Этот интерфейс представляет свойство кадра стека, свойство документа программы или другое свойство. Свойство обычно является результатом вычисления выражения.

Примечание.

Это использование свойства не следует путать с тем, что означает переменную члена класса, хотя может IDebugProperty2 представлять такую сущность.

Синтаксис

IDebugProperty2 : IUnknown

Примечания для разработчиков

DE реализует этот интерфейс для представления определенного типа значения. Например, значение может быть числовым значением в результате вычисления выражения, контекста памяти, используемого для отображения памяти, или списка регистров и их значений.

Заметки для вызывающих абонентов

Вызов EvaluateSync или EvaluateAsync для получения этого интерфейса, представляющего результат оценки. IDebugExpression2::EvaluateAsync возвращает этот интерфейс, отправив интерфейс IDebugExpressionEvaluationCompleteEvent2 в SDM, который, в свою очередь, вызывает GetResult для получения свойства.

  • GetDebugProperty возвращает этот интерфейс для предоставления связанного документа скрипта.

  • GetReturnValue возвращает этот интерфейс для представления возвращаемого значения функции.

  • GetDebugProperty возвращает этот интерфейс для представления различных свойств программы, таких как имя или контекст памяти.

  • GetDebugProperty возвращает этот интерфейс для представления различных свойств кадра стека, таких как локальные переменные.

Методы в порядке таблицы Vtable

В следующей таблице показаны методы IDebugProperty2.

Метод Description
GetPropertyInfo Заполняет структуру DEBUG_PROPERTY_INFO , описывающую свойство.
SetValueAsString Задает значение свойства из строки.
SetValueAsReference Задает значение свойства из значения заданной ссылки.
EnumChildren Перечисляет дочерние элементы свойства.
GetParent Возвращает родительский объект свойства.
GetDerivedMostProperty Возвращает свойство, описывающее наиболее производное свойство свойства.
GetMemoryBytes Возвращает байты памяти, составляющие значение свойства.
GetMemoryContext Возвращает контекст памяти для значения свойства.
GetSize Возвращает размер значения свойства в байтах.
GetReference Возвращает ссылку на значение этого свойства.
GetExtendedInfo Возвращает расширенные сведения о свойстве.

Замечания

Свойство, представленное IDebugProperty2 интерфейсом, можно рассматривать как значение с именем, типом и адресом. В более общих терминах может представлять все, IDebugProperty2 что имеет иерархическую структуру, с родителями и дочерними узлами.

Обычно свойство является транзитивным, которое длится только до тех пор, пока текущий кадр стека, например. С другой стороны, ссылка, представленная интерфейсом IDebugReference2 , длится до тех пор, пока значение остается в памяти.

Интегрированная среда разработки может использовать IDebugProperty2 интерфейс, чтобы пользователи могли просматривать и изменять свойства во время выполнения.

Requirements

Заголовок: msdbg.h

Пространство имен: Microsoft.VisualStudio.Debugger.Interop

Сборка: Microsoft.VisualStudio.Debugger.Interop.dll

См. также