ICorDebugStepper-Schnittstelle
Stellt einen Schritt in der Codeausführung dar, der von einem Debugger ausgeführt wird, dient zwischen der Veröffentlichung und dem Abschluss eines Befehls als Bezeichner und ermöglicht das Abbrechen eines Schritts.
Methoden
| Methode | Beschreibung |
|---|---|
| Deactivate-Methode | Bewirkt, dass ICorDebugStepper den zuletzt empfangenen Schrittbefehl abbricht. |
| IsActive-Methode | Ruft einen Wert ab, der angibt, ob ICorDebugStepper zurzeit einen Schritt ausführt. |
| SetInterceptMask-Methode | Legt einen CorDebugIntercept-Wert fest, der die Codetypen angibt, die schrittweise ausgeführt werden. |
| SetRangeIL-Methode | Legt einen Wert fest, der angibt, ob Aufrufe von ICorDebugStepper::StepRange Argumentwerte relativ zum systemeigenen Code oder zum CIL-Code (Common Intermediate Language) der Methode übergeben, die durchlaufen wird. |
| SetUnmappedStopMask-Methode | Legt einen CorDebugUnmappedStop-Wert fest, der den Typ des nicht zugeordneten Codes angibt, bei dem die Ausführung angehalten wird. |
| Step-Methode | Bewirkt, dass ICorDebugStepper den enthaltenden Thread in Einzelschritten durchläuft. Optional werden Funktionen, die innerhalb des Threads aufgerufen werden, ebenfalls in Einzelschritten durchlaufen. |
| StepOut-Methode | Bewirkt, dass ICorDebugStepper den enthaltenden Thread in Einzelschritten durchläuft und abgeschlossen wird, wenn der aktuelle Frame die Steuerung an den aufrufenden Frame zurückgibt. |
| StepRange-Methode | Bewirkt, dass ICorDebugStepper den enthaltenden Thread in Einzelschritten durchläuft und bei Erreichen von Code jenseits des letzten der angegebenen Bereiche zurückgegeben wird. |
Bemerkungen
Die Schnittstelle ICorDebugStepper dient den folgenden Zwecken:
Sie fungiert als Bezeichner zwischen der Ausgabe und dem Abschluss eines Schrittbefehls.
Sie bietet eine zentrale Schnittstelle, um alle durchführbaren Schritte zu kapseln.
Sie bietet eine Möglichkeit, eine schrittweise Ausführung vorzeitig abzubrechen.
Pro Thread kann mehr als ein Stepper-Element vorhanden sein. So kann beim schrittweisen Durchlaufen einer Funktion beispielsweise ein Haltepunkt erreicht werden, und die Benutzerin oder der Benutzer möchte innerhalb dieser Funktion eine neue Schrittausführung starten. Es liegt im Ermessen des Debuggers, wie mit einer solchen Situation umzugehen ist. Der Debugger kann die ursprüngliche Schrittausführung abbrechen oder die beiden Vorgänge schachteln. Die Schnittstelle ICorDebugStepper unterstützt beide Optionen.
Ein Stepper-Element kann zwischen Threads migriert werden, wenn die Common Language Runtime (CLR) einen threadübergreifenden, gemarshallten Aufruf sendet.
Hinweis
Diese Schnittstelle kann weder computerübergreifend noch prozessübergreifend remote aufgerufen werden.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorDebug.idl, CorDebug.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: Seit Version 1.0 verfügbar.
