Timer Sınıf

Tanım

Ad Alanı:

System.Threading

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Timer.cs

Belirtilen aralıklarla bir iş parçacığı havuzu iş parçacığında bir yöntemi yürütmek için bir mekanizma sağlar. Bu sınıf devralınamaz.

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

Devralma

Object

MarshalByRefObject

Timer

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.

Bahşiş

.NET, her biri farklı işlevler sunan çeşitli zamanlayıcı sınıfları içerir:

• System.Timers.Timer, bir olayı tetikler ve kodu düzenli aralıklarla bir veya daha fazla olay havuzu içinde yürütür. sınıfı, çok iş parçacıklı bir ortamda sunucu tabanlı veya hizmet bileşeni olarak kullanılmak üzere tasarlanmıştır; kullanıcı arabirimi yoktur ve çalışma zamanında görünmez.
• System.Threading.Timer, bir iş parçacığı havuzu iş parçacığında düzenli aralıklarla tek bir geri çağırma yöntemi yürütür. Geri çağırma yöntemi, zamanlayıcı örneği oluşturulurken tanımlanır ve değiştirilemez. System.Timers.Timer sınıfı gibi bu sınıf da çok iş parçacıklı bir ortamda sunucu tabanlı veya hizmet bileşeni olarak kullanılmak üzere tasarlanmıştır; kullanıcı arabirimi yoktur ve çalışma zamanında görünmez.
• System.Windows.Forms.Timer, bir olayı tetikleyen ve kodu düzenli aralıklarla bir veya daha fazla olay havuzu içinde yürüten bir Windows Forms bileşenidir. Bileşenin kullanıcı arabirimi yoktur ve tek iş parçacıklı bir ortamda kullanılmak üzere tasarlanmıştır; kullanıcı arabirimi iş parçacığında yürütülür.
• System.Web.UI.Timer (yalnızca.NET Framework), düzenli aralıklarla zaman uyumsuz veya zaman uyumlu web sayfası geri göndermesi gerçekleştiren bir ASP.NET bileşenidir.
• System.Windows.Threading.DispatcherTimer, Dispatcher kuyruğuyla tümleştirilmiş bir zamanlayıcıdır. Bu süreölçer belirtilen bir zaman aralığında belirtilen bir öncelikle işlenir.

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.

Not

bir Timerkullandığınız sürece, buna bir başvuru tutmanız gerekir. Herhangi bir yönetilen nesnede olduğu gibi, bir Timer başvuru olmadığında çöp toplamaya tabidir. Bir Timer hala etkin olması, toplanmasını engellemez.

Not

Kullanılan sistem saati, GetTickCounttarafından kullanılan saatle aynıdır ve timeBeginPeriod ve timeEndPeriodile yapılan değişikliklerden etkilenmez.

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.

Not

System.Threading.Timer, geri çağırma yöntemlerini kullanan ve iş parçacığı havuzu iş parçacıkları tarafından sunulan basit, basit bir zamanlayıcıdır. Geri çağırmaları kullanıcı arabirimi iş parçacığında gerçekleşmediğinden Windows Forms ile kullanılması önerilmez. System.Windows.Forms.Timer, Windows Forms ile kullanmak için daha iyi bir seçimdir. Sunucu tabanlı zamanlayıcı işlevselliği için, olayları tetikleyen ve ek özelliklere sahip olan System.Timers.Timerkullanmayı düşünebilirsiniz.

Oluşturucular

Timer(TimerCallback)	Yeni oluşturulan Timer nesnesini durum nesnesi olarak kullanarak Timer sınıfının yeni bir örneğini sonsuz bir süre ve sonsuz bir süreyle başlatır.
Timer(TimerCallback, Object, Int32, Int32)	Zaman aralığını belirtmek için 32 bit imzalı bir tamsayı kullanarak Timer sınıfının yeni bir örneğini başlatır.
Timer(TimerCallback, Object, Int64, Int64)	Zaman aralıklarını ölçmek için 64 bit imzalı tamsayıları kullanarak Timer sınıfının yeni bir örneğini başlatır.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Zaman aralıklarını ölçmek için TimeSpan değerleri kullanarak Timer sınıfının yeni bir örneğini başlatır.
Timer(TimerCallback, Object, UInt32, UInt32)	Zaman aralıklarını ölçmek için 32 bit işaretsiz tamsayılar kullanarak Timer sınıfının yeni bir örneğini başlatır.

Özellikler

ActiveCount

Şu anda etkin olan zamanlayıcıların sayısını alır. Etkin süreölçer gelecekte belirli bir noktada işaretlenmek üzere kaydedilir ve henüz iptal edilmemiştir.

Yöntemler

Change(Int32, Int32)	Zaman aralıklarını ölçmek için 32 bit imzalı tamsayıları kullanarak zamanlayıcının başlangıç saatini ve yöntem çağrıları arasındaki aralığı değiştirir.
Change(Int64, Int64)	Zaman aralıklarını ölçmek için 64 bit imzalı tamsayıları kullanarak zamanlayıcının başlangıç saatini ve yöntem çağrıları arasındaki aralığı değiştirir.
Change(TimeSpan, TimeSpan)	Zaman aralıklarını ölçmek için TimeSpan değerleri kullanarak zamanlayıcının başlangıç saatini ve yöntem çağrıları arasındaki aralığı değiştirir.
Change(UInt32, UInt32)	Zaman aralıklarını ölçmek için 32 bit işaretsiz tamsayılar kullanarak zamanlayıcının başlangıç saatini ve yöntem çağrıları arasındaki aralığı değiştirir.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	geçerli Timerörneği tarafından kullanılan tüm kaynakları serbest bırakır.
Dispose(WaitHandle)	geçerli Timer örneği tarafından kullanılan tüm kaynakları serbest bırakır ve zamanlayıcı atıldığında sinyaller gönderir.
DisposeAsync()	geçerli Timerörneği tarafından kullanılan tüm kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Uzantı Metotları

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılı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