ThreadPoolTimer Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili timer yang dibuat dengan CreateTimer atau CreatePeriodicTimer.
Catatan
ThreadPool API didukung untuk desktop serta aplikasi UWP.
public ref class ThreadPoolTimer sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ThreadPoolTimer final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ThreadPoolTimer
Public NotInheritable Class ThreadPoolTimer
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Kode berikut menunjukkan pembuatan timer berkala dengan meneruskan metode delegasi TimerElapsedHandler .
int period = 1000;
ThreadPoolTimer PeriodicTimer =
ThreadPoolTimer.CreatePeriodicTimer(ExampleTimerElapsedHandler,
TimeSpan.FromMilliseconds(period));
Setelah aplikasi Anda selesai menggunakan timer, aplikasi harus dibatalkan. Kode berikut membatalkan timer berkala yang dibuat dalam contoh sebelumnya.
if (PeriodicTimer != null)
{
PeriodicTimer.Cancel();
}
Keterangan
Metode CreatePeriodicTimer atau CreateTimer dapat digunakan untuk membuat objek ini.
Catatan
Nilai TimeSpan nol (atau nilai apa pun yang kurang dari 1 milidetik) akan menyebabkan timer berkala bereaksi sebagai timer bidikan tunggal.
Properti
Delay |
Mendapatkan nilai batas waktu dari timer penggunaan tunggal yang dibuat dengan CreateTimer. |
Period |
Mendapatkan nilai batas waktu timer berkala yang dibuat dengan CreatePeriodicTimer. |
Metode
Cancel() |
Membatalkan timer. |
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan) |
Membuat timer berkala. |
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler) |
Membuat timer berkala dan menentukan metode yang akan dipanggil setelah timer berkala selesai. Timer berkala selesai ketika timer telah kedaluwarsa tanpa diaktifkan kembali, dan panggilan akhir ke handler telah selesai. |
CreateTimer(TimerElapsedHandler, TimeSpan) |
Membuat timer sekali pakai. |
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler) |
Membuat timer sekali pakai dan menentukan metode yang akan dipanggil setelah timer selesai. Timer selesai ketika timer telah kedaluwarsa dan panggilan akhir ke handler telah selesai. |