Condividi tramite


Interfaccia ICorDebugStepper

Rappresenta un'istruzione nell'esecuzione di codice da parte di un debugger, opera da identificatore tra l'invio e il completamento di un comando e consente di annullare un'istruzione.

Metodi

Metodo

Oggetto di descrizione

Metodo ICorDebugStepper::Deactivate

Fa sì che ICorDebugStepper annulli l'ultimo comando di esecuzione istruzione ricevuto.

Metodo ICorDebugStepper::IsActive

Ottiene un valore che indica se ICorDebugStepper sta attualmente eseguendo un'istruzione.

Metodo ICorDebugStepper::SetInterceptMask

Imposta un valore CorDebugIntercept che specifica i tipi di codice per i quali è possibile eseguire istruzioni.

Metodo ICorDebugStepper::SetRangeIL

Imposta un valore che indica se le chiamate a ICorDebugStepper::StepRange passano valori di argomento relativi al codice nativo o al codice MSIL (Microsoft Intermediate Language) del metodo del quale viene eseguito il debug passo a passo.

Metodo ICorDebugStepper::SetUnmappedStopMask

Imposta un valore CorDebugUnmappedStop che specifica il tipo di codice non mappato nel quale verrà interrotta l'esecuzione.

Metodo ICorDebugStepper::Step

Fa sì che ICorDebugStepper esegua il debug passo a passo nel thread in cui l'oggetto è contenuto ed eventualmente continui tale debug per le funzioni chiamate nel thread.

Metodo ICorDebugStepper::StepOut

Fa sì che ICorDebugStepper esegua il debug passo a passo del thread in cui l'oggetto è contenuto e che venga completato quando il frame corrente restituisce il controllo al frame chiamante.

Metodo ICorDebugStepper::StepRange

Fa sì che ICorDebugStepper esegua il debug passo a passo del thread in cui l'oggetto è contenuto e che venga eseguito quando raggiunge il codice oltre l'ultimo degli intervalli specificati.

Note

L'interfaccia ICorDebugStepper ha i seguenti scopi:

  • Funge da identificatore tra un comando di debug passo a passo inviato e il completamento di tale comando.

  • Fornisce un'interfaccia centrale per incapsulare tutte le operazioni di debug passo a passo che è possibile eseguire.

  • Consente di annullare prima del tempo un'operazione di debug passo a passo.

È possibile che siano presenti più gestori di istruzioni per thread. Ad esempio, un punto di interruzione può essere attivato nel corso del debug passo a passo su una funzione e l'utente può desiderare di avviare una nuova operazione di debug passo a passo all'interno di tale funzione. È compito del debugger determinare come gestire questa situazione. Il debugger può annullare l'operazione di debug passo a passo originale o annidare le due operazioni. L’interfaccia ICorDebugStepper supporta entrambe le opzioni.

Un gestore di istruzioni può eseguire la migrazione fra thread se Common Language Runtime (CLR) effettua una chiamata cross-thread sottoposta a marshalling.

NotaNota

Questa interfaccia non supporta la ricezione di chiamate in modalità remota, siano esse tra più computer o processi.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Vedere anche

Riferimenti

Interfaccia ICorDebugStepper2

Altre risorse

Interfacce di debug