Интерфейс 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
