Bagikan melalui


Antarmuka ICorDebugStepper

Mewakili langkah dalam eksekusi kode yang dilakukan oleh debugger, berfungsi sebagai pengidentifikasi antara penerbitan dan penyelesaian perintah, dan menyediakan cara untuk membatalkan langkah.

Metode

Metode Deskripsi
Metode Nonaktifkan Menyebabkan ini ICorDebugStepper membatalkan perintah langkah terakhir yang diterimanya.
Metode IsActive Mendapatkan nilai yang menunjukkan apakah ini saat ini ICorDebugStepper menjalankan langkah.
Metode SetInterceptMask Mengatur nilai CorDebugIntercept yang menentukan jenis kode yang dilangkahi.
Metode SetRangeIL Menetapkan nilai yang menunjukkan apakah panggilan ke ICorDebugStepper::StepRange meneruskan nilai argumen relatif terhadap kode asli atau ke kode bahasa perantara umum (CIL) dari metode yang sedang dilangkahi.
Metode SetUnmappedStopMask Menetapkan nilai CorDebugUnmappedStop yang menentukan jenis kode yang tidak dipetakan di mana eksekusi akan dihentikan.
Metode Langkah Menyebabkan ini ICorDebugStepper untuk satu langkah melalui utas yang berisi, dan secara opsional, untuk melanjutkan satu langkah melalui fungsi yang dipanggil dalam utas.
Metode StepOut Menyebabkan ini ICorDebugStepper untuk satu langkah melalui utas yang berisi, dan selesai ketika bingkai saat ini mengembalikan kontrol ke bingkai panggilan.
Metode StepRange Menyebabkan ini ICorDebugStepper untuk satu langkah melalui utas yang berisi, dan kembali ketika mencapai kode di luar rentang terakhir yang ditentukan.

Keterangan

Antarmuka ICorDebugStepper melayani tujuan berikut:

  • Hal tersebut bertindak sebagai pengidentifikasi antara perintah langkah yang dikeluarkan dan penyelesaian perintah tersebut.

  • Hal tersebut menyediakan antarmuka pusat untuk merangkum semua langkah yang dapat dilakukan.

  • Hal tersebut menyediakan cara untuk membatalkan operasi langkah secara prematur.

Mungkin terdapat lebih dari satu stepper per utas. Misalnya, titik henti dapat ditemui saat melangkah di atas fungsi, dan pengguna mungkin ingin memulai operasi langkah baru di dalam fungsi tersebut. Terserah debugger untuk menentukan cara menangani situasi ini. Debugger mungkin ingin membatalkan operasi langkah asli atau menumpuk dua operasi. Antarmuka ICorDebugStepper mendukung kedua pilihan.

Stepper dapat bermigrasi di antara utas jika runtime bahasa umum (CLR) melakukan panggilan lintas utas dan di-marshall.

Catatan

Antarmuka ini tidak mendukung panggilan jarak jauh, baik antar komputer maupun antar proses.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorDebug.idl, CorDebug.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia sejak 1.0

Lihat juga