Timer Kelas

Definisi

Ruang nama:

System.Threading

Rakitan:

System.Runtime.dll

Sumber:

Timer.cs

Menyediakan mekanisme untuk menjalankan metode pada utas kumpulan utas pada interval yang ditentukan. Kelas ini tidak dapat diwariskan.

public ref class Timer sealed : MarshalByRefObject, System::Threading::ITimer

public sealed class Timer : MarshalByRefObject, System.Threading.ITimer

type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
    interface ITimer

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements ITimer

Warisan

Object

MarshalByRefObject

Timer

Penerapan

IDisposable IAsyncDisposable ITimer

Contoh

Contoh berikut mendefinisikan kelas StatusChecker yang menyertakan metode CheckStatus yang tanda tangannya sama dengan delegasi TimerCallback. Argumen state metode CheckStatus adalah objek AutoResetEvent yang digunakan untuk menyinkronkan utas aplikasi dan utas kumpulan utas yang menjalankan delegasi panggilan balik. Kelas StatusChecker juga mencakup dua variabel status:

invokeCount Menunjukkan berapa kali metode panggilan balik telah dipanggil.

maxCount Menentukan berapa kali metode panggilan balik harus dipanggil.

Utas aplikasi membuat timer, yang menunggu satu detik dan kemudian menjalankan metode panggilan balik CheckStatus setiap 250 milidetik. Utas aplikasi kemudian memblokir hingga objek AutoResetEvent diberi sinyal. Ketika metode panggilan balik CheckStatus dijalankan maxCount kali, metode ini memanggil metode AutoResetEvent.Set untuk mengatur status objek AutoResetEvent ke sinyal. Pertama kali ini terjadi, utas aplikasi memanggil metode Change(Int32, Int32) sehingga metode panggilan balik sekarang dijalankan setiap setengah detik. Ini sekali lagi memblokir sampai objek AutoResetEvent disinyalir. Ketika ini terjadi, timer dihancurkan dengan memanggil metode Dispose, dan aplikasi berakhir.

using namespace System;
using namespace System::Threading;

ref class StatusChecker
{
private:
    int invokeCount, maxCount;

public:
    StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    void CheckStatus(Object^ stateInfo)
    {
        AutoResetEvent^ autoEvent = dynamic_cast<AutoResetEvent^>(stateInfo);
        Console::WriteLine("{0:h:mm:ss.fff} Checking status {1,2}.",
                           DateTime::Now, ++invokeCount);

        if (invokeCount == maxCount) {
            // Reset the counter and signal the waiting thread.
            invokeCount  = 0;
            autoEvent->Set();
        }
    }
};

ref class TimerExample
{
public:
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        AutoResetEvent^ autoEvent = gcnew AutoResetEvent(false);

        StatusChecker^ statusChecker = gcnew StatusChecker(10);

        // Create a delegate that invokes methods for the timer.
        TimerCallback^ tcb =
           gcnew TimerCallback(statusChecker, &StatusChecker::CheckStatus);

        // Create a timer that invokes CheckStatus after one second, 
        // and every 1/4 second thereafter.
        Console::WriteLine("{0:h:mm:ss.fff} Creating timer.\n",
                           DateTime::Now);
        Timer^ stateTimer = gcnew Timer(tcb, autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent->WaitOne(5000, false);
        stateTimer->Change(0, 500);
        Console::WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent->WaitOne(5000, false);
        stateTimer->~Timer();
        Console::WriteLine("\nDestroying timer.");
    }
};

int main()
{
    TimerExample::Main();
}
// The example displays output like the following:
//       11:59:54.202 Creating timer.
//       
//       11:59:55.217 Checking status  1.
//       11:59:55.466 Checking status  2.
//       11:59:55.716 Checking status  3.
//       11:59:55.968 Checking status  4.
//       11:59:56.218 Checking status  5.
//       11:59:56.470 Checking status  6.
//       11:59:56.722 Checking status  7.
//       11:59:56.972 Checking status  8.
//       11:59:57.223 Checking status  9.
//       11:59:57.473 Checking status 10.
//       
//       Changing period to .5 seconds.
//       
//       11:59:57.474 Checking status  1.
//       11:59:57.976 Checking status  2.
//       11:59:58.476 Checking status  3.
//       11:59:58.977 Checking status  4.
//       11:59:59.477 Checking status  5.
//       11:59:59.977 Checking status  6.
//       12:00:00.478 Checking status  7.
//       12:00:00.980 Checking status  8.
//       12:00:01.481 Checking status  9.
//       12:00:01.981 Checking status 10.
//       
//       Destroying timer.

using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        var autoEvent = new AutoResetEvent(false);
        
        var statusChecker = new StatusChecker(10);

        // Create a timer that invokes CheckStatus after one second, 
        // and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer.\n", 
                          DateTime.Now);
        var stateTimer = new Timer(statusChecker.CheckStatus, 
                                   autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne();
        stateTimer.Change(0, 500);
        Console.WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne();
        stateTimer.Dispose();
        Console.WriteLine("\nDestroying timer.");
    }
}

class StatusChecker
{
    private int invokeCount;
    private int  maxCount;

    public StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    public void CheckStatus(Object stateInfo)
    {
        AutoResetEvent autoEvent = (AutoResetEvent)stateInfo;
        Console.WriteLine("{0} Checking status {1,2}.", 
            DateTime.Now.ToString("h:mm:ss.fff"), 
            (++invokeCount).ToString());

        if(invokeCount == maxCount)
        {
            // Reset the counter and signal the waiting thread.
            invokeCount = 0;
            autoEvent.Set();
        }
    }
}
// The example displays output like the following:
//       11:59:54.202 Creating timer.
//       
//       11:59:55.217 Checking status  1.
//       11:59:55.466 Checking status  2.
//       11:59:55.716 Checking status  3.
//       11:59:55.968 Checking status  4.
//       11:59:56.218 Checking status  5.
//       11:59:56.470 Checking status  6.
//       11:59:56.722 Checking status  7.
//       11:59:56.972 Checking status  8.
//       11:59:57.223 Checking status  9.
//       11:59:57.473 Checking status 10.
//       
//       Changing period to .5 seconds.
//       
//       11:59:57.474 Checking status  1.
//       11:59:57.976 Checking status  2.
//       11:59:58.476 Checking status  3.
//       11:59:58.977 Checking status  4.
//       11:59:59.477 Checking status  5.
//       11:59:59.977 Checking status  6.
//       12:00:00.478 Checking status  7.
//       12:00:00.980 Checking status  8.
//       12:00:01.481 Checking status  9.
//       12:00:01.981 Checking status 10.
//       
//       Destroying timer.

Imports System.Threading

Public Module Example
    Public Sub Main()
        ' Use an AutoResetEvent to signal the timeout threshold in the
        ' timer callback has been reached.
        Dim autoEvent As New AutoResetEvent(False)

        Dim statusChecker As New StatusChecker(10)

        ' Create a timer that invokes CheckStatus after one second, 
        ' and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer." & vbCrLf, 
                          DateTime.Now)
        Dim stateTimer As New Timer(AddressOf statusChecker.CheckStatus, 
                                    autoEvent, 1000, 250)

        ' When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne()
        stateTimer.Change(0, 500)
        Console.WriteLine(vbCrLf & "Changing period to .5 seconds." & vbCrLf)

        ' When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne()
        stateTimer.Dispose()
        Console.WriteLine(vbCrLf & "Destroying timer.")
    End Sub
End Module

Public Class StatusChecker
    Dim invokeCount, maxCount As Integer 

    Sub New(count As Integer)
        invokeCount  = 0
        maxCount = count
    End Sub

    ' The timer callback method.
    Sub CheckStatus(stateInfo As Object)
        Dim autoEvent As AutoResetEvent = DirectCast(stateInfo, AutoResetEvent)
        invokeCount += 1
        Console.WriteLine("{0:h:mm:ss.fff} Checking status {1,2}.", 
                          DateTime.Now, invokeCount)
        If invokeCount = maxCount Then
            ' Reset the counter and signal the waiting thread.
            invokeCount = 0
            autoEvent.Set()
        End If
    End Sub
End Class
' The example displays output like the following:
'       11:59:54.202 Creating timer.
'       
'       11:59:55.217 Checking status  1.
'       11:59:55.466 Checking status  2.
'       11:59:55.716 Checking status  3.
'       11:59:55.968 Checking status  4.
'       11:59:56.218 Checking status  5.
'       11:59:56.470 Checking status  6.
'       11:59:56.722 Checking status  7.
'       11:59:56.972 Checking status  8.
'       11:59:57.223 Checking status  9.
'       11:59:57.473 Checking status 10.
'       
'       Changing period to .5 seconds.
'       
'       11:59:57.474 Checking status  1.
'       11:59:57.976 Checking status  2.
'       11:59:58.476 Checking status  3.
'       11:59:58.977 Checking status  4.
'       11:59:59.477 Checking status  5.
'       11:59:59.977 Checking status  6.
'       12:00:00.478 Checking status  7.
'       12:00:00.980 Checking status  8.
'       12:00:01.481 Checking status  9.
'       12:00:01.981 Checking status 10.
'       
'       Destroying timer.

Keterangan

Gunakan delegasi TimerCallback untuk menentukan metode yang Anda inginkan untuk dijalankan Timer. Tanda tangan delegasi TimerCallback adalah:

void TimerCallback(Object state)

void TimerCallback(Object state)

Sub TimerCallback(state As Object)

Delegasi timer ditentukan ketika timer dibangun, dan tidak dapat diubah. Metode tidak dijalankan pada utas yang membuat timer; dijalankan pada utas ThreadPool yang disediakan oleh sistem.

Ujung

.NET mencakup beberapa kelas timer, yang masing-masing menawarkan fungsionalitas yang berbeda:

• System.Timers.Timer, yang menembakkan peristiwa dan menjalankan kode dalam satu atau beberapa sink peristiwa secara berkala. Kelas ini ditujukan untuk digunakan sebagai komponen berbasis server atau layanan di lingkungan multithreaded; tidak memiliki antarmuka pengguna dan tidak terlihat pada runtime.
• System.Threading.Timer, yang menjalankan metode panggilan balik tunggal pada utas kumpulan utas secara berkala. Metode panggilan balik didefinisikan ketika timer dibuat dan tidak dapat diubah. Seperti kelas System.Timers.Timer, kelas ini ditujukan untuk digunakan sebagai komponen berbasis server atau layanan di lingkungan multithreaded; tidak memiliki antarmuka pengguna dan tidak terlihat pada runtime.
• System.Windows.Forms.Timer, komponen Windows Forms yang mengaktifkan peristiwa dan menjalankan kode dalam satu atau beberapa sink peristiwa secara berkala. Komponen tidak memiliki antarmuka pengguna dan dirancang untuk digunakan dalam lingkungan satu utas; dijalankan pada utas UI.
• System.Web.UI.Timer (hanya.NET Framework), komponen ASP.NET yang melakukan postback halaman web asinkron atau sinkron secara berkala.
• System.Windows.Threading.DispatcherTimer, timer yang diintegrasikan ke dalam antrean Dispatcher. Timer ini diproses dengan prioritas tertentu pada interval waktu tertentu.

Saat membuat timer, Anda dapat menentukan jumlah waktu untuk menunggu sebelum eksekusi pertama metode (waktu jatuh tempo), dan jumlah waktu untuk menunggu antara eksekusi berikutnya (titik). Kelas Timer memiliki resolusi yang sama dengan jam sistem. Ini berarti bahwa jika periode kurang dari resolusi jam sistem, delegasi TimerCallback akan dijalankan pada interval yang ditentukan oleh resolusi jam sistem, yaitu sekitar 15 milidetik pada sistem Windows 7 dan Windows 8. Anda dapat mengubah waktu dan periode jatuh tempo, atau menonaktifkan timer, dengan menggunakan metode Change.

Nota

Selama Anda menggunakan Timer, Anda harus menyimpan referensi ke dalamnya. Seperti halnya objek terkelola apa pun, Timer tunduk pada pengumpulan sampah ketika tidak ada referensi untuk itu. Fakta bahwa Timer masih aktif tidak mencegahnya dikumpulkan.

Nota

Jam sistem yang digunakan adalah jam yang sama yang digunakan oleh GetTickCount, yang tidak terpengaruh oleh perubahan yang dilakukan dengan timeBeginPeriod dan timeEndPeriod.

Ketika timer tidak lagi diperlukan, gunakan metode Dispose untuk membebaskan sumber daya yang disimpan oleh timer. Perhatikan bahwa panggilan balik dapat terjadi setelah metode Dispose() kelebihan beban dipanggil, karena timer mengantrekan panggilan balik untuk eksekusi oleh utas kumpulan utas. Anda dapat menggunakan metode Dispose(WaitHandle) kelebihan beban untuk menunggu hingga semua panggilan balik selesai.

Metode panggilan balik yang dijalankan oleh timer harus masuk kembali, karena dipanggil pada utas ThreadPool. Panggilan balik dapat dijalankan secara bersamaan pada dua utas kumpulan utas jika interval timer kurang dari waktu yang diperlukan untuk menjalankan panggilan balik, atau jika semua utas kumpulan utas sedang digunakan dan panggilan balik diantrekan beberapa kali.

Nota

System.Threading.Timer adalah timer sederhana dan ringan yang menggunakan metode panggilan balik dan dilayani oleh utas kumpulan utas. Tidak disarankan untuk digunakan dengan Windows Forms, karena panggilan baliknya tidak terjadi pada utas antarmuka pengguna. System.Windows.Forms.Timer adalah pilihan yang lebih baik untuk digunakan dengan Windows Forms. Untuk fungsionalitas timer berbasis server, Anda mungkin mempertimbangkan untuk menggunakan System.Timers.Timer, yang meningkatkan peristiwa dan memiliki fitur tambahan.

Konstruktor

Timer(TimerCallback)	Menginisialisasi instans baru kelas Timer dengan periode tak terbatas dan waktu jatuh tempo tak terbatas, menggunakan objek Timer yang baru dibuat sebagai objek status.
Timer(TimerCallback, Object, Int32, Int32)	Menginisialisasi instans baru kelas Timer, menggunakan bilangan bulat bertanda tangan 32-bit untuk menentukan interval waktu.
Timer(TimerCallback, Object, Int64, Int64)	Menginisialisasi instans baru kelas Timer, menggunakan bilangan bulat bertanda tangan 64-bit untuk mengukur interval waktu.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Menginisialisasi instans baru kelas Timer, menggunakan nilai TimeSpan untuk mengukur interval waktu.
Timer(TimerCallback, Object, UInt32, UInt32)	Menginisialisasi instans baru kelas Timer, menggunakan bilangan bulat yang tidak ditandatangani 32-bit untuk mengukur interval waktu.

Properti

ActiveCount

Mendapatkan jumlah timer yang saat ini aktif. Timer aktif didaftarkan untuk berdetak di beberapa titik di masa mendatang, dan belum dibatalkan.

Metode

Change(Int32, Int32)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda tangan 32-bit untuk mengukur interval waktu.
Change(Int64, Int64)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda tangan 64-bit untuk mengukur interval waktu.
Change(TimeSpan, TimeSpan)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan nilai TimeSpan untuk mengukur interval waktu.
Change(UInt32, UInt32)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat yang tidak ditandatangani 32-bit untuk mengukur interval waktu.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang digunakan oleh instans Timersaat ini.
Dispose(WaitHandle)	Merilis semua sumber daya yang digunakan oleh instans Timer dan sinyal saat ini ketika timer telah dibuang.
DisposeAsync()	Merilis semua sumber daya yang digunakan oleh instans Timersaat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai akan dilakukan.

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• TimerCallback
• Timer
• Kumpulan Utas Terkelola