Интерфейс ICorDebugStepper

  • Статья

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

Методы

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

Замечания

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

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

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

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

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

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

Примечание.

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

Требования

Платформы: см. раздел Требования к системе.

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

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

версии платформа .NET Framework: Доступно с версии 1.0

См. также