Interfaccia ICorDebugStepper

Rappresenta un passaggio nell'esecuzione del codice eseguito da un debugger, funge da identificatore tra il rilascio e il completamento di un comando e fornisce un modo per annullare un passaggio.

Methods

Metodo	Description
Deactivate, metodo	Determina l'annullamento ICorDebugStepper dell'ultimo comando del passaggio ricevuto.
IsActive, metodo	Ottiene un valore che indica se è ICorDebugStepper in esecuzione un passaggio.
SetInterceptMask, metodo	Imposta un valore CorDebugIntercept che specifica i tipi di codice inseriti.
SetRangeIL, metodo	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.
SetUnmappedStopMask, metodo	Imposta un valore CorDebugUnmappedStop che specifica il tipo di codice non mappato in cui verrà interrotta l'esecuzione.
Step, metodo	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.
StepOut, metodo	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.
StepRange, metodo	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.

Annotazioni

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

Requisiti

Piattaforme: Vedere Sistemi operativi supportati da .NET.

Intestazione: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versioni di .NET: Disponibile a partire da .NET Framework 1.0