IDebugProperty2

Diese Schnittstelle stellt eine Stapelrahmen dokumenteigenschaft Programm eine Eigenschaft oder eine beliebige andere Eigenschaft dar. Die Eigenschaft ist gewöhnlich das Ergebnis der Ausdrucksauswertung.

Hinweis

Dieser Verwendung von „Eigenschaft“ sollte nicht zu verwechseln mit dieser Bedeutung einer Membervariablen einer Klasse, obwohl IDebugProperty2 eine solche Entität darstellen kann.

IDebugProperty2 : IUnknown

Hinweise für Implementierer

DE implementiert diese Schnittstelle, um eine bestimmte Weise Wert darstellt. Beispielsweise könnte der Wert eines numerischen Werts aufgrund einer Ausdrucksauswertung, einem Speicher, der für die Anzeige des Arbeitsspeichers verwendet wurden, oder eine Liste von Registern und deren Werte sein.

Hinweise für Aufrufer

Rufen Sie IDebugExpression2::EvaluateSync oder IDebugExpression2::EvaluateAsync an, die zum Abrufen dieser Schnittstelle, die das Ergebnis der Auswertung darstellt. IDebugExpression2::EvaluateAsync gibt diese Schnittstelle zurück, indem eine Schnittstelle zum IDebugExpressionEvaluationCompleteEvent2 SDM sendet, das wiederum IDebugExpressionEvaluationCompleteEvent2::GetResult aufgerufen wird, um die Eigenschaft abgerufen werden soll.

IDebugPropertyCreateEvent2::GetDebugProperty gibt diese Schnittstelle zurück, um das zugeordnete Dokument Skript zur Verfügung zu stellen.

IDebugReturnValueEvent2::GetReturnValue gibt diese Schnittstelle zurück, die den Rückgabewert einer Funktion darstellt.

IDebugProgram2::GetDebugProperty gibt diese Schnittstelle zurück, um verschiedene Eigenschaften des Programms z. B. ein Name oder ein Kontext Speicher darzustellen.

IDebugStackFrame2::GetDebugProperty gibt diese Schnittstelle zurück, um verschiedene Eigenschaften des Stapelrahmens z. B. lokale Variablen darstellt.

Methoden in die Vtable-Reihenfolge

In der folgenden Tabelle werden die Methoden von IDebugProperty2an.

Methode	Beschreibung
IDebugProperty2::GetPropertyInfo	Füllt eine DEBUG_PROPERTY_INFORMATION Struktur aus, die eine Eigenschaft beschreibt.
IDebugProperty2::SetValueAsString	Legt den Wert einer Eigenschaft aus einer Zeichenfolge fest.
IDebugProperty2::SetValueAsReference	Legt den Wert der Eigenschaft vom Wert eines angegebenen Verweises ab.
IDebugProperty2::EnumChildren	Listet die untergeordneten Elemente einer Eigenschaft.
IDebugProperty2::GetParent	Gibt das übergeordnete Element einer Eigenschaft zurück.
IDebugProperty2::GetDerivedMostProperty	Gibt die Eigenschaft zurück, die die höchst-abgeleitete Eigenschaft einer Eigenschaft beschreibt.
IDebugProperty2::GetMemoryBytes	Gibt die Bytes an Arbeitsspeicher zurück, die den Wert einer Eigenschaft zusammensetzt.
IDebugProperty2::GetMemoryContext	Gibt den Kontext des Arbeitsspeichers für einen Eigenschaftswert zurück.
IDebugProperty2::GetSize	Gibt die Größe (in Bytes) des Eigenschaftswerts zurück.
IDebugProperty2::GetReference	Gibt einen Verweis auf das Wert der Eigenschaft zurück.
IDebugProperty2::GetExtendedInfo	Gibt die erweiterten Informationen zu einer Eigenschaft zurück.

Hinweise

Eine Eigenschaft, die durch eine IDebugProperty2-Schnittstelle dargestellt, kann für einen Wert mit einem Namen, einem Typ und einer Adresse angesehen werden. In Ausdrücken kann den allgemeineren IDebugProperty2 alles, das eine Struktur verfügt, mit übergeordneten Elementen und untergeordneten Knoten darstellen.

Eine Eigenschaft ist vorübergehend und dauert in der Regel nur solange der aktuelle Stapelrahmen, z. B. Umgekehrt nimmt ein Verweis, z. B. durch eine IDebugReference2-Schnittstelle dargestellt, solange der Wert im Arbeitsspeicher verbleibt.

Die IDE kann die IDebugProperty2-Schnittstelle verwenden, um Benutzer durchsuchen und Eigenschaften zur Laufzeit geändert werden soll.

Anforderungen

Header: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Siehe auch

Referenz

DEBUG_PROPERTY_INFORMATION

IDebugReference2

Konzepte

Kern-Schnittstellen