Bagikan melalui

Antarmuka ICLRTask

Menyediakan metode yang memungkinkan host membuat permintaan runtime bahasa umum (CLR), atau untuk memberikan pemberitahuan kepada runtime bahasa umum tentang tugas terkait.

Metode

Metode Deskripsi
Metode Abort Meminta runtime bahasa umum membatalkan tugas yang diwakili instans saat ini ICLRTask.
Metode ExitTask Memberi tahu runtime bahasa umum bahwa tugas yang terkait dengan instans saat ini ICLRTask berakhir, dan mencoba mematikan tugas dengan baik.
GetMemStats Metode Mendapatkan informasi statistik tentang penggunaan sumber daya memori oleh tugas yang diwakili oleh instans saat ini ICLRTask.
Metode LocksHeld Mendapatkan jumlah kunci yang saat ini dipegang pada tugas.
Metode NeedsPriorityScheduling Mendapatkan nilai yang menunjukkan apakah host harus menetapkan prioritas tinggi untuk menjadwalkan ulang tugas yang diwakili oleh instans saat ini ICLRTask.
Metode Reset Memberi tahu runtime bahasa umum bahwa host telah menyelesaikan tugas, dan memungkinkan runtime bahasa umum untuk menggunakan kembali instans saat ini ICLRTask untuk mewakili tugas lain.
Metode RudeAbort Menyebabkan runtime bahasa umum membatalkan tugas yang diwakili oleh instans saat ini ICLRTask segera, tanpa jaminan bahwa finalizer akan dijalankan.
Metode SetTaskIdentifier Mengatur pengidentifikasi unik untuk tugas yang diwakili oleh instans saat ini ICLRTask, untuk digunakan dalam penelusuran kesalahan.
Metode SwitchIn Memberi tahu runtime bahasa umum bahwa tugas yang diwakili oleh instans saat ini ICLRTask dalam keadaan dapat dioperasikan.
Metode SwitchOut Memberi tahu CLR bahwa tugas yang diwakili oleh instans saat ini ICLRTask dalam keadaan dapat dioperasikan.
Metode YieldTask Permintaan agar runtime bahasa umum membuat waktu prosesor tersedia untuk tugas lain. Runtime bahasa umum tidak menjamin bahwa tugas akan dimasukkan ke dalam keadaan di mana ia dapat menghasilkan waktu pemrosesan.

Keterangan

ICLRTask adalah representasi tugas untuk Runtime Bahasa Umum. Kapan saja selama eksekusi kode, tugas dapat dijelaskan baik sebagai menjalankan atau menunggu untuk dijalankan. Host memanggil ICLRTask::SwitchIn metode untuk memberi tahu runtime bahasa umum bahwa tugas yang diwakili instans saat ini ICLRTask sekarang dalam keadaan dapat dioperasikan. Setelah panggilan ke ICLRTask::SwitchIn, host dapat menjadwalkan tugas pada rangkaian sistem operasi apa pun, kecuali dalam kasus di mana runtime bahasa umum memerlukan rangkaian afinitas, seperti yang ditentukan oleh panggilan ke metode IHostTaskManager::BeginThreadAffinity dan IHostTaskManager::EndThreadAffinity. Beberapa waktu kemudian, sistem operasi mungkin memutuskan untuk menghapus tugas dari rangkaian dan menempatkannya dalam status tidak berjalan. Misalnya, ini mungkin terjadi setiap kali tugas memblokir primitif sinkronisasi, atau menunggu operasi I/O selesai. Host memanggil SwitchOut untuk memberitahu runtime bahasa umum bahwa tugas yang diwakili oleh instans saat iniICLRTask sudah tidak lagi dalam status dapat beroperasi.

Tugas biasanya berakhir pada akhir eksekusi kode. Pada saat itu, host memanggil ICLRTask::ExitTask untuk menghancurkan yang terkait ICLRTask. Namun, tugas juga dapat didaur ulang dengan menggunakan panggilan ke ICLRTask::Reset, yang memungkinkan ICLRTask instans digunakan lagi. Pendekatan ini mencegah overhead membuat dan menghancurkan instans berulang kali.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on