Debugger3-Schnittstelle
Mit Debugger3 können die Zustände des Debuggers und des derzeit gedebuggten Programms abgefragt und bearbeitet werden. Debugger3 hat Vorrang vor der Debugger2-Schnittstelle und der Debugger-Schnittstelle.
Namespace: EnvDTE90
Assembly: EnvDTE90 (in EnvDTE90.dll)
Syntax
'Declaration
<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")> _
Public Interface Debugger3 _
Inherits Debugger2
[GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface Debugger3 : Debugger2
[GuidAttribute(L"87DFC8DA-67B4-4954-BB89-6A277A50BAFC")]
public interface class Debugger3 : Debugger2
[<GuidAttribute("87DFC8DA-67B4-4954-BB89-6A277A50BAFC")>]
type Debugger3 =
interface
interface Debugger2
end
public interface Debugger3 extends Debugger2
Der Debugger3-Typ macht die folgenden Member verfügbar.
Eigenschaften
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
AllBreakpointsLastHit | (Von Debugger2 geerbt.) |
|
AllBreakpointsLastHit | Ruft eine Auflistung der gebundenen Haltepunkte ab, die als letztes gleichzeitig erreicht wurden. |
|
BreakpointLastHit | (Von Debugger2 geerbt.) |
|
BreakpointLastHit | Ruft den zuletzt erreichten Haltepunkt ab. |
|
Breakpoints | (Von Debugger2 geerbt.) |
|
Breakpoints | Ruft eine Auflistung von Haltepunkten ab. |
|
CurrentMode | (Von Debugger2 geerbt.) |
|
CurrentMode | Ruft den aktuellen Modus des Debuggers im Kontext der IDE ab. |
|
CurrentProcess | (Von Debugger2 geerbt.) |
|
CurrentProcess | Ruft den aktiven Prozess ab oder legt ihn fest. |
|
CurrentProgram | (Von Debugger2 geerbt.) |
|
CurrentProgram | Legt das aktive Programm fest oder gibt dieses zurück. |
|
CurrentStackFrame | (Von Debugger2 geerbt.) |
|
CurrentStackFrame | Ruft den aktuellen Stapelrahmen ab oder legt ihn fest. |
|
CurrentThread | (Von Debugger2 geerbt.) |
|
CurrentThread | Ruft den aktuellen Thread ab, der gedebuggt wird, oder legt ihn fest. |
|
DebuggedProcesses | (Von Debugger2 geerbt.) |
|
DebuggedProcesses | Ruft eine Liste der Prozesse ab, die gedebuggt werden. |
|
DTE | (Von Debugger2 geerbt.) |
|
DTE | Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab. |
|
ExceptionGroups | Ruft die Ausnahmeeinstellungen für den Debugger ab.Bei jeder Ausnahme kann durch diese Einstellungen festgelegt werden, dass die Ausnahme durch den Code behandelt wird, bevor die Ausführung vom Debugger unterbrochen wird. |
|
ForceContinue | Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Debugger die Anwendung unterbricht oder fortführt, wenn die Ausführung eines Makros durch einen Ablaufverfolgungspunkt oder einen Haltepunkt beendet wird.Das Standardverhalten wird beim Erstellen des Ablaufverfolgungs- oder Haltepunkts im Dialogfeld durch den Benutzer festgelegt.Diese Eigenschaft kann verwendet werden, um das Standardverhalten zu ändern. |
|
HexDisplayMode | (Von Debugger2 geerbt.) |
|
HexDisplayMode | Ruft den Wert ab, der angibt, ob die Ausdrücke als Dezimal- oder Hexadezimalwert ausgegeben werden, oder legt diesen Wert fest. |
|
HexInputMode | (Von Debugger2 geerbt.) |
|
HexInputMode | Ruft einen Wert ab, der angibt, ob die Ausdrücke als Dezimal- oder Hexadezimalwert ausgewertet werden, oder legt diesen Wert fest. |
|
Languages | (Von Debugger2 geerbt.) |
|
Languages | Ruft eine Liste der vom Debugger unterstützten Sprachen ab. |
|
LastBreakReason | (Von Debugger2 geerbt.) |
|
LastBreakReason | Ruft die zuletzt aufgetretene Ursache für den Programmabsturz ab.Bei laufendem Programm wird DBG_REASON_NONE zurückgegeben. |
|
LocalProcesses | (Von Debugger2 geerbt.) |
|
LocalProcesses | Ruft die Liste der Prozesse ab, die zurzeit auf dem Computer ausgeführt werden. |
|
OnlyLoadSymbolsManually | Ruft einen Wert ab, der festlegt, ob Symbole manuell oder automatisch geladen werden.Der Visual Studio-Benutzer kann diese Einstellung im Dialogfeld Optionen festlegen.Weitere Informationen über das Festlegen dieses Werts in Visual Studio finden Sie unter Gewusst wie: Angeben von Symbolspeicherorten und Ladeverhalten. |
|
Parent | (Von Debugger2 geerbt.) |
|
Parent | Ruft das unmittelbar übergeordnete Objekt des Debugger3-Objekts (DTE2) ab. |
|
SymbolCachePath | Ruft eine Zeichenfolge ab, die den Pfad zum Speicherort des in Visual Studio verwendeten Symbolcaches enthält, wenn Sie Symbole von einem Symbolserver herunterladen.Sie können den Pfad zum Symbolcache im Dialogfeld Optionen angeben.Weitere Informationen finden Sie unter Gewusst wie: Verwenden eines Symbolservers. |
|
SymbolPath | Ruft eine Zeichenfolge ab, die Pfade zu den von Visual Studio zum Debuggen verwendeten PDB-Symboldateien enthält.Der Visual Studio-Benutzer kann die Symbolpfade im Dialogfeld Optionen festlegen.Weitere Informationen hierzu finden Sie unter Gewusst wie: Angeben von Symbolspeicherorten und Ladeverhalten. |
|
SymbolPathState | Ruft eine Zeichenfolge ab, die den Zustand aller Symbolpfade zu den PDB-Symboldateien enthält, die von Visual Studio zum Debuggen verwendet werden. |
|
Transports | (Von Debugger2 geerbt.) |
|
Transports | Ruft eine Auflistung der unterstützten Debugtransporte ab. |
Zum Seitenanfang
Methoden
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Methode") |
Break(Boolean) | (Von Debugger2 geerbt.) |
|
Break(Boolean) | Bewirkt, dass dieser Prozess angehalten wird, sodass der aktuelle Zustand analysiert werden kann. |
|
DetachAll() | (Von Debugger2 geerbt.) |
|
DetachAll() | Trennt alle angefügten Programme. |
|
ExecuteStatement(String, Int32, Boolean) | (Von Debugger2 geerbt.) |
|
ExecuteStatement(String, Int32, Boolean) | Führt die angegebene Anweisung aus.Wenn das TreatAsExpression-Flag auf true festgelegt ist, wird die Zeichenfolge als Ausdruck interpretiert und die Ausgabe an Befehlsfenster gesendet. |
|
GetExpression(String, Boolean, Int32) | (Von Debugger2 geerbt.) |
|
GetExpression(String, Boolean, Int32) | Wertet einen Ausdruck auf Grundlage des aktuellen Stapelrahmens aus.Wenn ein Ausdruck analysiert, aber nicht ausgewertet werden kann, wird ein Objekt zurückgegeben, das jedoch keinen gültigen Wert besitzt. |
|
GetExpression2(String, Boolean, Boolean, Int32) | (Von Debugger2 geerbt.) |
|
GetExpression2(String, Boolean, Boolean, Int32) | Wertet einen Ausdruck auf Grundlage des aktuellen Stapelrahmens aus.Wenn ein Ausdruck analysiert, aber nicht ausgewertet werden kann, wird ein Objekt zurückgegeben, das jedoch keinen gültigen Wert besitzt.Diese Memberfunktion ist dem GetExpression ähnlich. Sie enthält jedoch einen zusätzlichen booleschen Parameter, der auf "true" gesetzt werden kann, um darauf hinzuweisen, dass der Ausdruck als Anweisung ausgewertet werden soll. |
|
GetProcesses(Transport, String) | (Von Debugger2 geerbt.) |
|
GetProcesses(Transport, String) | |
|
Go(Boolean) | (Von Debugger2 geerbt.) |
|
Go(Boolean) | Startet die Programmausführung von der aktuellen Anweisung. |
|
RunToCursor(Boolean) | (Von Debugger2 geerbt.) |
|
RunToCursor(Boolean) | Führt das Programm bis zur aktuellen Position des Cursors in der Quelldatei aus. |
|
SetNextStatement() | (Von Debugger2 geerbt.) |
|
SetNextStatement() | Legt gemäß der Cursorposition in der aktuellen Quelldatei die nächste auszuführende Anweisung fest. |
|
SetSymbolSettings | Legt verschiedene Einstellungen für die in Visual Studio zum Debuggen verwendeten PDB-Symbole fest, und erzwingt das erneute Laden aller Symbole. |
|
StepInto(Boolean) | (Von Debugger2 geerbt.) |
|
StepInto(Boolean) | Führt einen Einzelschritt in den nächsten Funktionsaufruf aus, falls möglich. |
|
StepOut(Boolean) | (Von Debugger2 geerbt.) |
|
StepOut(Boolean) | Verlässt die aktuelle Funktion. |
|
StepOver(Boolean) | (Von Debugger2 geerbt.) |
|
StepOver(Boolean) | Überspringt den nächsten Funktionsaufruf. |
|
Stop(Boolean) | (Von Debugger2 geerbt.) |
|
Stop(Boolean) | Hält den Debugvorgang an und beendet oder trennt alle angefügten Prozesse. |
|
TerminateAll() | (Von Debugger2 geerbt.) |
|
TerminateAll() | Beendet alle laufenden Programme, die momentan gedebuggt werden. |
|
WriteMinidump(String, dbgMinidumpOption) | (Von Debugger2 geerbt.) |
|
WriteMinidump(String, dbgMinidumpOption) |
Zum Seitenanfang
Hinweise
Der Debugger wird über das DTE2-Objekt, genauer über dessen Debugger-Eigenschaft, bereitgestellt, wie Sie dem folgenden Beispiel entnehmen können. Für jede Instanz der interaktiven Entwicklungsumgebung (IDE) ist ein Debuggerobjekt verfügbar.
Beispiele
Imports System
Imports EnvDTE
Imports EnvDTE90
Imports EnvDTE90
Imports System.Diagnostics
Public Module Module1
'This function returns true if the debugger is actively debugging.
Function IsDebugging() As Boolean
Dim debugger As EnvDTE90.Debugger3
debugger = DTE.Debugger
If (debugger Is Nothing) Then
MsgBox("Debugger doesn't exist! Fatal error.")
IsDebugging = false
Else
IsDebugging = (debugger.CurrentMode <> _
dbgDebugMode.dbgDesignMode)
End If
End Function
End Module
// The following C++ program can be run from the command line.
// It detects whether an instance of Visual Studio is currently
// running,and if so, prints a message stating whether its debugger
// is actively debugging.
#include <stdio.h>
#import "dte90.olb" raw_interfaces_only named_guids
using namespace EnvDTE90;
int main(void)
{
int nRet = 0;
CoInitialize(NULL);
IUnknownPtr pUnk;
GetActiveObject(CLSID_DTE, NULL, &pUnk);
if (pUnk == NULL) {
printf ("No instance of Visual Studio is running.\n");
}
else {
_DTEPtr pDTE = pUnk;
if (pDTE) {
DebuggerPtr pDebugger;
if (SUCCEEDED(pDTE->get_Debugger(&pDebugger3)) &&
pDebugger3
!= NULL){
dbgDebugMode mode;
if (SUCCEEDED(pDebugger3->get_CurrentMode(&mode))) {
if (mode != dbgDesignMode) {
printf("Debugger is active.\n");
nRet = 1;
}
else {
printf("Debugger is not active.\n");
}
}
}
}
}
CoUninitialize();
return nRet;
}