ThreadPoolTimer Kelas

Definisi

Ruang nama:

Windows.System.Threading

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

Object Platform::Object IInspectable ThreadPoolTimer

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.