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 isso ICorDebugStepper cancele o comando da última etapa recebido.
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 percorridos.
Método SetRangeIL Define um valor que indica se as chamadas para ICorDebugStepper:: StepRange passam valores de argumentos relativos ao código nativo ou ao código MSIL (Microsoft Intermediate Language) 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 isso ICorDebugStepper para uma única etapa por meio de seu thread que o contém e, opcionalmente, para continuar percorrendo por meio de funções que são chamadas dentro do thread.
Método StepOut Faz isso ICorDebugStepper para uma única etapa por meio de seu thread que o contém e para concluir quando o quadro atual retorna o controle para o quadro de chamada.
Método StepRange Faz isso ICorDebugStepper para uma única etapa por meio de seu thread que o contém e retorna quando ele atinge o código após o último dos intervalos especificados.

Comentários

A ICorDebugStepper interface atende às seguintes finalidades:

  • Ele atua como um identificador entre um comando Step que é emitido e a conclusão desse comando.

  • Ele fornece uma interface central para encapsular toda a depuração que pode ser executada.

  • Ele fornece uma maneira de cancelar prematuramente uma operação de depuração.

Pode haver mais de um stepper por thread. Por exemplo, um ponto de interrupção pode ser atingido durante a depuração em uma função, e o usuário pode desejar iniciar uma nova operação de depuração dentro dessa função. Cabe ao depurador determinar como lidar com essa situação. O depurador pode querer cancelar a operação de depuração original ou aninhar as duas operações. A ICorDebugStepper interface dá suporte a ambas as opções.

Um stepper poderá migrar entre threads se o Common Language Runtime (CLR) fizer uma chamada de marshaling em vários threads.

Observação

Esta interface não dá suporte para chamada remota, seja entre computadores ou processos cruzados.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

.NET Framework versões:Disponível desde o 1.0

Consulte também