Timer Sınıf

Tanım

public ref class Timer sealed : IDisposable

public ref class Timer sealed : MarshalByRefObject, IAsyncDisposable, IDisposable

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

public ref class Timer sealed : MarshalByRefObject, IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : IDisposable

public sealed class Timer : MarshalByRefObject, IAsyncDisposable, IDisposable

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

public sealed class Timer : MarshalByRefObject, IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : MarshalByRefObject, IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    interface IDisposable

type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

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

type Timer = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class Timer
Implements IDisposable

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements ITimer

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IDisposable

Devralma

Object

Timer

Devralma

Object

MarshalByRefObject

Timer

Öznitelikler

ComVisibleAttribute

Uygulamalar

IDisposable IAsyncDisposable ITimer

Örnekler

Aşağıdaki örnek, imzası TimerCallback temsilcisiyle aynı olan bir CheckStatus yöntemi içeren bir StatusChecker sınıfını tanımlar. CheckStatus yönteminin state bağımsız değişkeni, uygulama iş parçacığını ve geri çağırma temsilcisini yürüten iş parçacığı havuzu iş parçacığını eşitlemek için kullanılan bir AutoResetEvent nesnesidir. StatusChecker sınıfı iki durum değişkeni de içerir:

invokeCount Geri çağırma yönteminin çağrılma sayısını gösterir.

maxCount Geri çağırma yönteminin en fazla kaç kez çağrılması gerektiğini belirler.

Uygulama iş parçacığı, bir saniye bekleyip her 250 milisaniyede bir CheckStatus geri çağırma yöntemini yürüten zamanlayıcıyı oluşturur. Uygulama iş parçacığı daha sonra AutoResetEvent nesnesi sinyal alınana kadar engeller. CheckStatus geri çağırma yöntemi maxCount kez yürütürse, AutoResetEvent nesnesinin durumunu işaretlendi olarak ayarlamak için AutoResetEvent.Set yöntemini çağırır. Bu ilk kez gerçekleştiğinde, uygulama iş parçacığı Change(Int32, Int32) yöntemini çağırır, böylece geri çağırma yöntemi artık yarım saniyede bir yürütülür. bir kez daha AutoResetEvent nesnesi işaretlenene kadar engeller. Bu durumda zamanlayıcı, Dispose yöntemi çağrılarak yok edilir ve uygulama sonlandırılır.

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.

Açıklamalar

Timer yürütülmesini istediğiniz yöntemi belirtmek için bir TimerCallback temsilcisi kullanın. TimerCallback temsilcisinin imzası:

void TimerCallback(Object state)

void TimerCallback(Object state)

Sub TimerCallback(state As Object)

Zamanlayıcı temsilcisi, zamanlayıcı oluşturulduğunda belirtilir ve değiştirilemez. yöntemi zamanlayıcıyı oluşturan iş parçacığında yürütülmüyor; sistem tarafından sağlanan bir ThreadPool iş parçacığında yürütülür.

Zamanlayıcı oluşturduğunuzda, yöntemin ilk yürütülmesinden önce bekleyebileceğiniz süreyi (son süre) ve sonraki yürütmeler (nokta) arasında bekleyebileceğiniz süreyi belirtebilirsiniz. Timer sınıfı sistem saati ile aynı çözünürlüğe sahiptir. Bu, süre sistem saatinin çözünürlüğünden küçükse, TimerCallback temsilcisinin Windows 7 ve Windows 8 sistemlerinde yaklaşık 15 milisaniye olan sistem saatinin çözünürlüğüyle tanımlanan aralıklarla yürütüleceği anlamına gelir. Change yöntemini kullanarak son zamanı ve süreyi değiştirebilir veya zamanlayıcıyı devre dışı bırakabilirsiniz.

Zamanlayıcı artık gerekli olmadığında, zamanlayıcı tarafından tutulan kaynakları boşaltmak için Dispose yöntemini kullanın. Zamanlayıcı, iş parçacığı havuzu iş parçacıkları tarafından yürütülmeye yönelik geri çağırmaları kuyruğa aldığı için, Dispose() yöntemi aşırı yüklemesi çağrıldıktan sonra geri çağırmaların gerçekleşebileceğini unutmayın. Tüm geri çağırmalar tamamlanana kadar beklemek için Dispose(WaitHandle) yöntemi aşırı yüklemesini kullanabilirsiniz.

Zamanlayıcı tarafından yürütülen geri çağırma yöntemi, ThreadPool iş parçacıklarında çağrıldığından yeniden giriş yapmalıdır. Zamanlayıcı aralığı geri çağırmayı yürütmek için gereken süreden kısaysa veya tüm iş parçacığı havuzu iş parçacıkları kullanımdaysa ve geri çağırma birden çok kez kuyruğa alınmışsa, geri çağırma iki iş parçacığı havuzu iş parçacığında aynı anda yürütülebilir.

Oluşturucular

Özellikler

Yöntemler

Uzantı Metotları

Şunlara uygulanır

İş Parçacığı Güvenliği

Bu tür iş parçacığı güvenlidir.

Ayrıca bkz.

• TimerCallback
• Zamanlayıcıları
• Yönetilen İş Parçacığı Havuzu