ICorDebugStepper-Schnittstelle

Stellt einen Schritt in der Codeausführung dar, der von einem Debugger ausgeführt wird, dient als Bezeichner zwischen der Ausstellung und Abschluss eines Befehls und bietet eine Möglichkeit zum Abbrechen eines Schritts.

Methodik

Methode	Description
Deactivate-Methode	Bewirkt, dass der ICorDebugStepper letzte empfangene Schrittbefehl abgebrochen wird.
IsActive-Methode	Ruft einen Wert ab, der angibt, ob dies ICorDebugStepper derzeit einen Schritt ausführt.
SetInterceptMask-Methode	Legt einen CorDebugIntercept-Wert fest, der die Codetypen angibt, in die ein Schritt ausgeführt wird.
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, in dem die Ausführung angehalten wird.
Step-Methode	Führt dazu, dass dies ICorDebugStepper einstufiger Durchlauf durch den enthaltenden Thread erfolgt und optional die Einzelschrittfunktion fortgesetzt wird, die innerhalb des Threads aufgerufen werden.
StepOut-Methode	Führt dazu, dass der ICorDebugStepper thread enthaltende Thread einzeln durchlaufen wird und abgeschlossen wird, wenn der aktuelle Frame das Steuerelement an den aufrufenden Frame zurückgibt.
StepRange-Methode	Führt dazu, dass dies ICorDebugStepper einen einzelnen Schritt durch den enthaltenden Thread durchläuft und zurückgegeben wird, wenn der Code über den letzten der angegebenen Bereiche hinaus erreicht wird.

Bemerkungen

Die ICorDebugStepper Schnittstelle dient den folgenden Zwecken:

• Er fungiert als Bezeichner zwischen einem ausgegebenen Schrittbefehl und dem Abschluss dieses Befehls.

• Es stellt eine zentrale Schnittstelle bereit, um alle Schritte zu kapseln, die ausgeführt werden können.

• Sie bietet eine Möglichkeit, einen Schrittvorgang vorzeitig abzubrechen.

Pro Thread kann mehr als ein Schritt ausgeführt werden. Beispielsweise kann ein Haltepunkt beim Durchlaufen einer Funktion getroffen werden, und der Benutzer möchte möglicherweise einen neuen Schritt innerhalb dieser Funktion starten. Es liegt an dem Debugger, um zu bestimmen, wie diese Situation behandelt wird. Der Debugger möchte möglicherweise den ursprünglichen Schrittvorgang abbrechen oder die beiden Vorgänge verschachteln. Die ICorDebugStepper Schnittstelle unterstützt beide Optionen.

Ein Stepper kann zwischen Threads migriert werden, wenn die Common Language Runtime (CLR) einen threadübergreifenden, ge marshallten Aufruf vorgibt.

Hinweis

Diese Schnittstelle unterstützt nicht die Remote-Aufrufe, entweder computerübergreifend oder prozessübergreifend.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 1.0