Kelas task_continuation_context
Kelas ini task_continuation_context memungkinkan Anda menentukan di mana Anda ingin kelanjutan dijalankan. Hanya berguna untuk menggunakan kelas ini dari aplikasi Windows Runtime. Untuk aplikasi Runtime non-Windows, konteks eksekusi kelanjutan tugas ditentukan oleh runtime, dan tidak dapat dikonfigurasi.
Sintaks
class task_continuation_context : public details::_ContextCallback;
Anggota
Metode Publik
| Nama | Deskripsi |
|---|---|
| get_current_winrt_context | Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks utas winrt saat ini. |
| use_arbitrary | Membuat konteks kelanjutan tugas yang memungkinkan Runtime memilih konteks eksekusi untuk kelanjutan. |
| use_current | Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks eksekusi saat ini. |
| use_default | Membuat konteks kelanjutan tugas default. |
| use_synchronous_execution | Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks eksekusi sinkron. |
Hierarki Warisan
_ContextCallback
task_continuation_context
Persyaratan
Header: ppltasks.h
Namespace: konkurensi
get_current_winrt_context
Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks utas WinRT saat ini.
Sintaks
static task_continuation_context get_current_winrt_context();
Tampilkan Nilai
Konteks utas Windows Runtime saat ini. Mengembalikan task_continuation_context kosong jika dipanggil dari konteks Runtime non-Windows.
Keterangan
Metode ini get_current_winrt_context menangkap konteks utas Windows Runtime pemanggil. Ini mengembalikan konteks kosong ke penelepon Runtime non-Windows.
Nilai yang dikembalikan oleh get_current_winrt_context dapat digunakan untuk menunjukkan kepada Runtime bahwa kelanjutan harus dijalankan dalam model apartemen dari konteks yang ditangkap (STA vs MTA), terlepas dari apakah tugas antecedent sadar apartemen. Tugas sadar apartemen adalah tugas yang membongkar antarmuka Windows Runtime IAsyncInfo , atau tugas yang turun dari tugas seperti itu.
Metode ini mirip use_current dengan metode ini, tetapi juga tersedia untuk kode C++ asli tanpa dukungan ekstensi C++/CX. Ini ditujukan untuk digunakan oleh pengguna tingkat lanjut yang menulis kode pustaka C++/CX-agnostik untuk pemanggil asli dan Windows Runtime. Kecuali Anda memerlukan fungsionalitas ini, kami merekomendasikan use_current metode , yang hanya tersedia untuk klien C++/CX.
use_arbitrary
Membuat konteks kelanjutan tugas yang memungkinkan Runtime memilih konteks eksekusi untuk kelanjutan.
Sintaks
static task_continuation_context use_arbitrary();
Tampilkan Nilai
Konteks kelanjutan tugas yang mewakili lokasi arbitrer.
Keterangan
Ketika konteks kelanjutan ini digunakan, kelanjutan akan dijalankan dalam konteks yang dipilih runtime meskipun tugas antecedent sadar apartemen.
use_arbitrary dapat digunakan untuk menonaktifkan perilaku default untuk kelanjutan pada tugas sadar apartemen yang dibuat di STA.
Metode ini hanya tersedia untuk aplikasi Windows Runtime.
use_current
Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks eksekusi saat ini.
static task_continuation_context use_current();
Tampilkan Nilai
Konteks eksekusi saat ini.
Keterangan
Metode ini menangkap konteks Windows Runtime penelepon sehingga kelanjutan dapat dijalankan di apartemen yang tepat.
Nilai yang dikembalikan oleh use_current dapat digunakan untuk menunjukkan kepada Runtime bahwa kelanjutan harus dijalankan dalam konteks yang ditangkap (STA vs MTA) terlepas dari apakah tugas antecedent sadar apartemen atau tidak. Tugas sadar apartemen adalah tugas yang membongkar antarmuka Windows Runtime IAsyncInfo , atau tugas yang turun dari tugas seperti itu.
Metode ini hanya tersedia untuk aplikasi Windows Runtime.
use_default
Membuat konteks kelanjutan tugas default.
static task_continuation_context use_default();
Tampilkan Nilai
Konteks kelanjutan default.
Keterangan
Konteks default digunakan jika Anda tidak menentukan konteks kelanjutan saat Anda memanggil then metode . Di aplikasi Windows untuk Windows 7 ke bawah, serta aplikasi desktop pada Windows 8 dan yang lebih tinggi, runtime menentukan di mana kelanjutan tugas akan dijalankan. Namun, dalam aplikasi Windows Runtime, konteks kelanjutan default untuk kelanjutan pada tugas sadar apartemen adalah apartemen tempat then dipanggil.
Tugas sadar apartemen adalah tugas yang membongkar antarmuka Windows Runtime IAsyncInfo , atau tugas yang turun dari tugas seperti itu. Oleh karena itu, jika Anda menjadwalkan kelanjutan pada tugas sadar apartemen di Windows Runtime STA, kelanjutannya akan dijalankan di STA tersebut.
Kelanjutan pada tugas sadar non-apartemen akan dijalankan dalam konteks yang dipilih Runtime.
task_continuation_context::use_synchronous_execution
Mengembalikan objek konteks kelanjutan tugas yang mewakili konteks eksekusi sinkron.
Sintaks
static task_continuation_context use_synchronous_execution();
Tampilkan Nilai
Konteks eksekusi sinkron.
Keterangan
Metode ini use_synchronous_execution memaksa tugas kelanjutan berjalan secara sinkron pada konteks, menyebabkan penyelesaian tugas anteksnya.
Jika tugas antecedent telah selesai ketika kelanjutan dilampirkan, kelanjutan berjalan secara sinkron pada konteks yang melampirkan kelanjutan.