ICorDebugStepper::StepRange-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Veranlasst diesen ICorDebugStepper, den enthaltenen Thread in Einzelschritten auszuführen und zurückzugeben, wenn er Code nach dem letzten der angegebenen Bereiche erreicht hat.

HRESULT StepRange (
    [in] BOOL     bStepIn,
    [in, size_is(cRangeCount)] COR_DEBUG_STEP_RANGE ranges[],
    [in] ULONG32  cRangeCount
);

Parameter

bStepIn
[in] Wird auf true festgelegt, um eine Funktion, die innerhalb des Threads aufgerufen wird, schrittweise auszuführen. Wird auf false festgelegt, um die Funktion zu überspringen.
ranges
[in] Ein Array von COR_DEBUG_STEP_RANGE-Strukturen, von denen jede einen Bereich angibt.
cRangeCount
[in] Die Größe des ranges-Arrays.

Hinweise

Die StepRange-Methode funktioniert wie die ICorDebugStepper::Step-Methode. Sie wird allerdings erst abgeschlossen, wenn Code außerhalb des angegebenen Bereichs erreicht wird.

Dies kann effizienter sein als Schritt für Schritt eine Anweisung auszuführen. Bereiche werden als Liste von Offsetpaaren vom Anfang des Stepperrahmens angegeben.

Bereiche sind zum Microsoft Intermediate Language-Code (MSIL) einer Methode relativ. Rufen Sie ICorDebugStepper::SetRangeIL mit false auf, um die Bereiche zum systemeigenen Code einer Methode relativ zu machen.