Condividi tramite

Interfaccia ICorDebugStepper

  • Articolo

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 Descrizione
Metodo Deactivate Determina l'annullamento ICorDebugStepper dell'ultimo comando del passaggio ricevuto.
Metodo IsActive Ottiene un valore che indica se è ICorDebugStepper in esecuzione un passaggio.
Metodo SetInterceptMask Imposta un valore CorDebugIntercept che specifica i tipi di codice inseriti.
Metodo SetRangeIL Imposta un valore che indica se le chiamate a ICorDebugStepper::StepRange passano valori di argomento relativi al codice nativo o al codice CIL (Common Intermediate Language) del metodo sottoposto a pass.
Metodo SetUnmappedStopMask Imposta un valore CorDebugUnmappedStop che specifica il tipo di codice non mappato in cui verrà interrotta l'esecuzione.
Metodo Step Fa sì che questa ICorDebugStepper operazione venga eseguita in un unico passaggio attraverso il thread contenitore e, facoltativamente, per continuare a eseguire un'istruzione singola tramite le funzioni chiamate all'interno del thread.
Metodo StepOut Fa in modo che questa ICorDebugStepper operazione venga eseguita in un unico passaggio attraverso il thread contenitore e venga completata quando il frame corrente restituisce il controllo al frame chiamante.
Metodo StepRange In questo modo viene ICorDebugStepper eseguito un unico passaggio attraverso il thread contenitore e viene restituito quando raggiunge il codice oltre l'ultimo degli intervalli specificati.

Osservazioni:

L'interfaccia ICorDebugStepper ha gli scopi seguenti:

  • Funge da identificatore tra un comando di passaggio che viene emesso e il completamento di tale comando.

  • Fornisce un'interfaccia centrale per incapsulare tutte le istruzioni che è possibile eseguire.

  • Consente di annullare prematuramente un'operazione di esecuzione.

Possono essere presenti più passaggi per ogni thread. Ad esempio, un punto di interruzione può essere raggiunto durante l'esecuzione di un'istruzione su una funzione e l'utente potrebbe voler avviare una nuova operazione di istruzione all'interno di tale funzione. Spetta al debugger determinare come gestire questa situazione. Il debugger può voler annullare l'operazione di esecuzione originale o annidare le due operazioni. L'interfaccia ICorDebugStepper supporta entrambe le opzioni.

Un stepper può eseguire la migrazione tra thread se Common Language Runtime (CLR) effettua una chiamata con marshalling incrociato.

Nota

Questa interfaccia non supporta la chiamata in modalità remota, tra computer o tra processi.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 1.0

Vedi anche