ICorDebugStepper Interface

Representa uma etapa na execução de código executada 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.

Methods

Método	Description
Desativar Método	Faz com que isso ICorDebugStepper cancele o comando da última etapa que recebeu.
Método IsActive	Obtém um valor que indica se isso ICorDebugStepper está executando uma etapa no momento.
Método SetInterceptMask	Define um valor CorDebugIntercept que especifica os tipos de código que são inseridos.
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 (common intermediate language) do método que está sendo percuzido.
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 isso ICorDebugStepper passe por um único passo por meio de seu thread que contém e, opcionalmente, continue percorrendo funções de passagem única que são chamadas dentro do thread.
Método StepOut	Faz com que isso ICorDebugStepper seja uma etapa única por meio do thread que contém e seja concluído quando o quadro atual retorna o controle para o quadro de chamada.
Método StepRange	Faz com que isso ICorDebugStepper seja uma etapa única por meio de seu thread que contém e retorne quando atingir o código além do último dos intervalos especificados.

Observações

A ICorDebugStepper interface serve para as seguintes finalidades:

• Ele atua como um identificador entre um comando de etapa emitido e a conclusão desse comando.

• Ele fornece uma interface central para encapsular todas as etapas que podem ser executadas.

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

Pode haver mais de um passo por thread. Por exemplo, um ponto de interrupção pode ser atingido ao passar por cima de uma função e o usuário pode querer iniciar uma nova operação de etapa dentro dessa função. Cabe ao depurador determinar como lidar com essa situação. Talvez o depurador queira cancelar a operação de etapa 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 CLR (Common Language Runtime) fizer uma chamada com thread cruzado.

Observação

Essa interface não dá suporte a ser chamada remotamente, seja entre máquinas ou entre processos.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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