ICorDebugStepper, interfejs
Reprezentuje krok wykonaniu kodu, który jest realizowany przez debuger; służy jako identyfikator między wydaniem i zakończeniem polecenia i zapewnia sposób anulowania kroku.
Metody
| Metoda | opis |
|---|---|
| Deactivate, metoda | Powoduje to ICorDebugStepper anulowanie ostatniego otrzymanego polecenia kroku. |
| IsActive, metoda | Pobiera wartość wskazującą, czy obecnie wykonuje to ICorDebugStepper krok. |
| SetInterceptMask, metoda | Ustawia wartość CorDebugIntercept, która określa typy kodu, które są wprowadzane. |
| SetRangeIL, metoda | Ustawia wartość wskazującą, czy wywołania metody ICorDebugStepper::StepRange przekazują wartości argumentów względem kodu natywnego lub kodu wspólnego języka pośredniego (CIL) metody przechodzącej. |
| SetUnmappedStopMask, metoda | Ustawia wartość CorDebugUnmappedStop, która określa typ niezamapowanego kodu, w którym wykonanie zostanie zatrzymane. |
| Step, metoda | Powoduje to ICorDebugStepper przejście przez pojedynczy krok przez jego zawierający wątek i opcjonalnie, aby kontynuować jednoetapowe przechodzenie przez funkcje wywoływane w wątku. |
| StepOut, metoda | Powoduje to ICorDebugStepper przejście przez pojedynczy krok przez jego zawierający wątek i ukończenie, gdy bieżąca ramka zwraca kontrolkę do ramki wywołującej. |
| StepRange, metoda | Powoduje to ICorDebugStepper przejście przez pojedynczy krok przez jego zawierający wątek i zwrócenie, gdy osiągnie kod poza ostatnim z określonych zakresów. |
Uwagi
Interfejs ICorDebugStepper służy do następujących celów:
Działa on jako identyfikator między poleceniem kroku, które zostało wydane i ukończeniem tego polecenia.
Zapewnia ona centralny interfejs do hermetyzacji wszystkich kroków, które można wykonać.
Umożliwia przedwczesne anulowanie operacji krokowania.
Może istnieć więcej niż jeden krok na wątek. Na przykład punkt przerwania może zostać trafiony podczas przechodzenia przez funkcję, a użytkownik może chcieć uruchomić nową operację krokową wewnątrz tej funkcji. Jest to do debugera, aby określić, jak poradzić sobie z tą sytuacją. Debuger może chcieć anulować oryginalną operację krokową lub zagnieżdżać dwie operacje. Interfejs ICorDebugStepper obsługuje obie opcje.
Krokowy może migrować między wątkami, jeśli środowisko uruchomieniowe języka wspólnego (CLR) wykonuje wywołanie międzywątkowa, z rozgłaszanym wywołaniem.
Uwaga
Ten interfejs nie obsługuje wywoływanego zdalnie, między maszynami lub między procesami.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl, CorDebug.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od wersji 1.0
