Interface ICorDebugStepper
Representa uma etapa na execução do código que é realizada por um depurador, serve como um identificador entre a emissão e a conclusão de um comando e fornece uma maneira de cancelar uma etapa.
Métodos
| Método | Descrição |
|---|---|
| Método Deactivate | Faz com que este ICorDebugStepper cancele o comando recebido da última etapa. |
| Método IsActive | Obtém um valor que indica se este ICorDebugStepper está executando uma etapa no momento. |
| Método SetInterceptMask | Define um valor CorDebugIntercept que especifica os tipos de código que são executados em etapas. |
| Método SetRangeIL | Define um valor que indica se as chamadas para ICorDebugStepper::StepRange passam valores de argumento relativos ao código nativo ou ao código CIL (linguagem intermediária comum) do método que está sendo percorrido. |
| Método SetUnmappedStopMask | Define um valor CorDebugUnmappedStop que especifica o tipo de código não mapeado no qual a execução será interrompida. |
| Método Step | Faz com que este ICorDebugStepper execute em uma só etapa o thread que contém e, opcionalmente, continue percorrendo funções que são chamadas no thread. |
| Método StepOut | Faz com que este ICorDebugStepper execute em uma só etapa o thread que contém e seja concluído quando o quadro atual retornar o controle para o quadro de chamada. |
| Método StepRange | Faz com que este ICorDebugStepper execute em uma só etapa o thread que contém e seja retornado quando ele atingir o código após o último dos intervalos especificados. |
Comentários
A interface ICorDebugStepper serve as seguintes finalidades:
Funciona como um identificador entre um comando de etapa emitido e a conclusão desse comando.
Fornece uma interface central para encapsular todas as etapas que podem ser executadas.
Fornece uma forma de cancelar prematuramente uma operação de execução em etapas.
Pode haver mais de um passador por thread. Por exemplo, um ponto de interrupção pode ser atingido durante a execução em etapas de uma função, e o usuário pode querer iniciar uma nova operação de execução em etapas dentro dessa função. Cabe ao depurador determinar como lidar com essa situação. Talvez o depurador queira cancelar a operação original de execução em etapas ou aninhar as duas operações. A interface ICorDebugStepper dá suporte a ambas as opções.
Um passador poderá migrar entre threads se o CLR (Common Language Runtime) fizer uma chamada com marshaling e thread cruzado.
Observação
Esta interface não pode ser chamada remotamente, seja entre computadores ou entre processos.
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: CorDebug.idl, CorDebug.h
Biblioteca: CorGuids.lib
Versões do .NET Framework: Disponíveis desde a versão 1.0
