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.

Methods

Metode	Description
Nonaktifkan Metode	Menyebabkan hal ini ICorDebugStepper membatalkan perintah langkah terakhir yang diterimanya.
Metode IsActive	Mendapatkan nilai yang menunjukkan apakah ini ICorDebugStepper sedang 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	Mengatur nilai CorDebugUnmappedStop yang menentukan jenis kode yang tidak dipetakan di mana eksekusi akan berhenti.
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 satu langkah melalui utas yang berisi, dan selesai ketika bingkai saat ini mengembalikan kontrol ke bingkai panggilan.
Metode StepRange	Menyebabkan ini ICorDebugStepper satu langkah melalui utas yang berisi, dan kembali ketika mencapai kode di luar rentang terakhir yang ditentukan.

Komentar

Antarmuka ICorDebugStepper melayani tujuan berikut:

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

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

• Ini menyediakan cara untuk membatalkan operasi melangkah secara prematur.

Mungkin ada lebih dari satu stepper per utas. Misalnya, titik henti dapat ditemui saat melangkahi 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) membuat panggilan lintas utas yang di-marshalled.

Nota

Antarmuka ini tidak mendukung dipanggil dari jarak jauh, baik lintas mesin atau lintas proses.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: CorDebug.idl, CorDebug.h

Perpustakaan: CorGuids.lib

Versi .NET: Tersedia sejak .NET Framework 1.0