Compartir a través de


ICorDebugStepper (Interfaz)

Representa un paso en la ejecución del código realizado por un depurador, actúa como identificador entre la emisión y la finalización de un comando, y proporciona un modo de cancelar un paso.

Métodos

Método

Descripción

ICorDebugStepper::Deactivate (Método)

Hace que esta instancia de ICorDebugStepper cancele el último comando de paso que ha recibido.

ICorDebugStepper::IsActive (Método)

Obtiene un valor que indica si esta instancia de ICorDebugStepper está ejecutando actualmente un paso.

ICorDebugStepper::SetInterceptMask (Método)

Establece un valor de CorDebugIntercept que especifica los tipos de código que se recorren paso a paso.

ICorDebugStepper::SetRangeIL (Método)

Establece un valor que indica si las llamadas a ICorDebugStepper::StepRange pasan valores de argumento que son relativos al código nativo o relativos al código del Lenguaje intermedio de Microsoft (MSIL) del método que se está ejecutando paso a paso.

ICorDebugStepper::SetUnmappedStopMask (Método)

Establece un valor de CorDebugUnmappedStop que especifica el tipo de código no asignado en el que se detendrá la ejecución.

ICorDebugStepper::Step (Método)

Hace que esta instancia de ICorDebugStepper se ejecute paso a paso a través del subproceso que la contiene y, de manera opcional, continúe ejecutándose paso a paso a través de las funciones a las que se llama desde el subproceso.

ICorDebugStepper::StepOut (Método)

Hace que esta instancia de ICorDebugStepper ejecute paso a paso el subproceso que la contiene y que finalice cuando el marco actual devuelva el control al marco que realizó la llamada.

ICorDebugStepper::StepRange (Método)

Hace que esta instancia de ICorDebugStepper se ejecute paso a paso en el subproceso que la contiene y que vuelva cuando llegue al código situado más allá del último de los intervalos especificados.

Comentarios

La interfaz ICorDebugStepper tiene las siguientes finalidades:

  • Actúa como identificador entre un comando de paso emitido y la ejecución de dicho comando.

  • Proporciona una interfaz central para encapsular todas las posibles operaciones de ejecución paso a paso.

  • Proporciona una manera de cancelar prematuramente una operación de ejecución paso a paso.

Puede haber más de un stepper por subproceso. Por ejemplo, es posible que se encuentre un punto de interrupción durante la ejecución paso a paso en una función y que el usuario desee iniciar una nueva operación de ejecución paso a paso dentro de esa función. Es decisión del depurador determinar la forma controlar esta situación. El depurador podría optar por cancelar la operación de ejecución paso a paso original o por anidar las dos operaciones. La interfaz ICorDebugStepper admite ambas opciones.

Un stepper puede migrar entre subprocesos si Common Language Runtime (CLR) realiza una llamada de cálculo de referencias entre subprocesos.

NotaNota

Esta interfaz no admite que se la llame de forma remota, ya sea entre procesos o entre equipos.

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Vea también

Referencia

ICorDebugStepper2 (Interfaz)

Otros recursos

Interfaces para depuración