ICorDebugStepper – rozhraní
Představuje krok ve spuštění kódu, který je prováděn pomocí ladicího programu, slouží jako identifikátor mezi vydáním a dokončením příkazu a umožňuje krok zrušit.
Metody
| metoda | Popis |
|---|---|
| Deactivate – metoda | Způsobí zrušení ICorDebugStepper posledního příkazu kroku, který přijal. |
| IsActive – metoda | Získá hodnotu, která označuje, zda se právě ICorDebugStepper provádí krok. |
| SetInterceptMask – metoda | Nastaví hodnotu CorDebugIntercept, která určuje typy kódu, které jsou stupňovité. |
| SetRangeIL – metoda | Nastaví hodnotu, která označuje, zda volání ICorDebugStepper::StepRange předávat hodnoty argumentů vzhledem k nativnímu kódu nebo kódu CIL (Common Intermediate Language) metody, která prochází. |
| SetUnmappedStopMask – metoda | Nastaví hodnotu CorDebugUnmappedStop, která určuje typ nemapovaného kódu, ve kterém se provádění zastaví. |
| Step – metoda | Způsobí to ICorDebugStepper , že jednokrokovým procházením jeho obsahující vlákno a volitelně bude pokračovat v jednoduchých krokování funkcí, které jsou volána v rámci vlákna. |
| StepOut – metoda | Způsobí to ICorDebugStepper , že jeden krok prochází jeho obsahující vlákno a dokončit, když aktuální rámec vrátí ovládací prvek volající rámec. |
| StepRange – metoda | Způsobí to ICorDebugStepper , že jeden krok prochází jeho obsahující vlákno a vrátí se, když dosáhne kódu nad rámec posledního zadaného rozsahu. |
Poznámky
Rozhraní ICorDebugStepper slouží k následujícím účelům:
Funguje jako identifikátor mezi příkazem kroku, který je vydán, a dokončením tohoto příkazu.
Poskytuje centrální rozhraní pro zapouzdření všech kroků, které lze provést.
Poskytuje způsob, jak předčasně zrušit krokovací operaci.
Pro každé vlákno může existovat více než jeden krokovač. Při procházení funkce může například dojít k zarážce a uživatel může chtít zahájit novou operaci krokování uvnitř této funkce. Je na ladicím programu, aby bylo možné určit, jak tuto situaci zvládnout. Ladicí program může chtít zrušit původní operaci krokování nebo vnořit dvě operace. Rozhraní ICorDebugStepper podporuje obě možnosti.
Krokovač se může migrovat mezi vlákny, pokud modul CLR (Common Language Runtime) provede křížové zařazované volání.
Poznámka:
Toto rozhraní nepodporuje vzdálené zavolání, a to buď mezi počítači, nebo mezi procesy.
Požadavky
Platformy: Viz požadavky na systém.
Hlavička: CorDebug.idl, CorDebug.h
Knihovna: CorGuids.lib
Verze rozhraní .NET Framework: Dostupné od verze 1.0
