Интерфейс ICorDebugStepper

Представляет шаг выполнения кода, выполняемого отладчиком, служит идентификатором между выдачой и завершением команды и предоставляет способ отмены шага.

Методы

Метод	Description
Деактивация метода	Приводит к отмене ICorDebugStepper полученной команды последнего шага.
Метод IsActive	Возвращает значение, указывающее, выполняется ли в ICorDebugStepper данный момент шаг.
Метод SetInterceptMask	Задает значение CorDebugIntercept, указывающее типы кода, в которые вошли.
Метод SetRangeIL	Задает значение, указывающее, передаются ли вызовы к значениям аргументов ICorDebugStepper::StepRange относительно машинного кода или кода общего языка (CIL) метода, который выполняется.
Метод SetUnmappedStopMask	Задает значение CorDebugUnmappedStop, указывающее тип несопоставленного кода, в котором будет остановлено выполнение.
Метод step	Это ICorDebugStepper приводит к одношаговой последовательности с его содержащим потоком и, при необходимости, продолжить одношаговые действия через функции, вызываемые в потоке.
Метод StepOut	Вызывает это ICorDebugStepper одношаговый переход через содержащий поток и завершение, когда текущий кадр возвращает элемент управления вызывающей рамке.
Метод StepRange	Вызывает это ICorDebugStepper одношаговый переход через содержащий поток и возвращать, когда он достигает кода за пределами последнего из указанных диапазонов.

Замечания

Интерфейс ICorDebugStepper служит следующим целям:

• Он выступает в качестве идентификатора между командой шага, выданной и завершением этой команды.

• Он предоставляет центральный интерфейс для инкапсулирования всех шагов, которые можно выполнить.

• Он предоставляет способ преждевременного отмены операции пошагового выполнения.

На поток может быть несколько шагов. Например, точка останова может быть достигнута при шаге над функцией, и пользователь может начать новую операцию пошагового выполнения внутри этой функции. Это зависит от отладчика, чтобы определить, как обрабатывать эту ситуацию. Отладчику может потребоваться отменить исходную операцию пошагового перехода или вложить две операции. Интерфейс ICorDebugStepper поддерживает оба варианта.

Шаговый элемент может переноситься между потоками, если среда CLR выполняет перекрестный маршалированный вызов.

Замечание

Этот интерфейс не поддерживает удаленный вызов между компьютерами или перекрестными процессами.

Требования

Платформ: См. сведения о поддерживаемых операционных системах .NET.

Заголовок: CorDebug.idl, CorDebug.h

Библиотека: CorGuids.lib

Версии .NET: Доступно с .NET Framework 1.0