ICorDebugStepper インターフェイス

デバッガーによって実行されるコード実行のステップを表し、コマンドの発行と完了の間の識別子として機能し、ステップを取り消す方法を提供します。

Methods

メソッド	Description
Deactivate メソッド	この ICorDebugStepper が受信した最後のステップ コマンドを取り消します。
IsActive メソッド	この ICorDebugStepper が現在ステップを実行しているかどうかを示す値を取得します。
SetInterceptMask メソッド	ステップ インするコードの種類を指定する CorDebugIntercept 値を設定します。
SetRangeIL メソッド	ICorDebugStepper::StepRange の呼び出しが、ネイティブ コードまたはステップ スルーされるメソッドの共通中間言語 (CIL) コードに対して引数値を渡すかどうかを示す値を設定します。
SetUnmappedStopMask メソッド	実行が停止するマップされていないコードの種類を指定する CorDebugUnmappedStop 値を設定します。
Step メソッド	この ICorDebugStepper を含むスレッドを単一ステップで実行し、必要に応じて、スレッド内で呼び出される関数のシングル ステップ実行を続行します。
StepOut メソッド	この ICorDebugStepper を含むスレッドを 1 ステップで実行し、現在のフレームが呼び出し元のフレームに制御を戻すときに完了します。
StepRange メソッド	この ICorDebugStepper を含むスレッドを単一ステップで実行し、指定した範囲の最後を超えてコードに到達したときに戻ります。

注釈

ICorDebugStepper インターフェイスは、次の目的で機能します。

• これは、発行されたステップ・コマンドとそのコマンドの完了との間の ID として機能します。

• 実行できるすべてのステップ実行をカプセル化するための中央インターフェイスが提供されます。

• ステップ実行操作を途中で取り消す方法を提供します。

スレッドごとに複数のステッピングを使用できます。 たとえば、関数のステップ オーバー中にブレークポイントにヒットし、ユーザーがその関数内で新しいステップ実行操作を開始したい場合があります。 この状況を処理する方法は、デバッガーによって決まります。 デバッガーは、元のステップ実行操作を取り消すか、2 つの操作を入れ子にすることができます。 ICorDebugStepper インターフェイスでは、両方の選択肢がサポートされています。

共通言語ランタイム (CLR) がクロススレッドのマーシャリングされた呼び出しを行う場合、ステッパーはスレッド間で移行できます。

注

このインターフェイスは、マシン間またはプロセス間のリモート呼び出しをサポートしていません。

Requirements

プラットフォーム：サポートされている .NET オペレーティング システムを参照してください。

ヘッダ： CorDebug.idl、CorDebug.h

図書館： CorGuids.lib

.NET のバージョン: .NET Framework 1.0 以降で使用可能