Timer 類別

參考

定義

命名空間:: System.Threading

組件:: System.Threading.Timer.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

來源:: Timer.cs

來源:: Timer.cs

來源:: Timer.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供機制，以指定間隔在線程集區線程上執行方法。無法繼承這個類別。

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

繼承: Object
Timer

繼承: Object

MarshalByRefObject
Timer

屬性: ComVisibleAttribute

實作: IDisposable IAsyncDisposable ITimer

範例

下列範例會定義 StatusChecker 類別，其中包含簽章與 TimerCallback 委派相同的 CheckStatus 方法。 CheckStatus 方法的 state 自變數是 AutoResetEvent 物件，用來同步處理應用程式線程和執行回呼委派的線程集區線程。 StatusChecker 類別也包含兩個狀態變數：

invokeCount 指出叫用回呼方法的次數。

maxCount 決定應該叫用回呼方法的次數上限。

應用程式線程會建立定時器，其會等候一秒，然後每隔 250 毫秒執行 CheckStatus 回呼方法。應用程式線程接著會封鎖，直到發出 AutoResetEvent 物件訊號為止。當 CheckStatus 回呼方法執行 maxCount 次時，它會呼叫 AutoResetEvent.Set 方法，將 AutoResetEvent 物件的狀態設定為訊號。第一次發生這種情況時，應用程式線程會呼叫 Change(Int32, Int32) 方法，讓回呼方法現在每半秒執行一次。它再次封鎖，直到發出 AutoResetEvent 物件訊號為止。發生這種情況時，定時器會藉由呼叫其 Dispose 方法終結，而應用程式會終止。

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.

備註

使用 TimerCallback 委派來指定您想要執行 Timer 的方法。 TimerCallback 委派的簽章為：

void TimerCallback(Object state)

void TimerCallback(Object state)

Sub TimerCallback(state As Object)

定時器委派是在建構定時器時指定，而且無法變更。方法不會在建立定時器的線程上執行;它會在系統提供的 ThreadPool 線程上執行。

提示

.NET 包含數個定時器類別，每個類別都提供不同的功能：

System.Timers.Timer，它會引發事件，並在一或多個事件接收中定期執行程序代碼。類別適用於在多線程環境中做為伺服器型或服務元件;它沒有使用者介面，而且在運行時間看不到。
System.Threading.Timer，它會定期在線程集區線程上執行單一回呼方法。當定時器具現化且無法變更時，就會定義回呼方法。如同 System.Timers.Timer 類別，這個類別是用來作為多線程環境中的伺服器型或服務元件;它沒有使用者介面，而且在運行時間看不到。
System.Windows.Forms.Timer，這是一個 Windows Forms 元件，會引發事件，並在一或多個事件接收中定期執行程式碼。元件沒有使用者介面，且設計用於單個線程環境中;它會在UI線程上執行。
System.Web.UI.Timer （僅限.NET Framework），ASP.NET 元件，會定期執行異步或同步網頁回傳。
System.Windows.Threading.DispatcherTimer，這是整合到 Dispatcher 佇列中的定時器。此定時器會以指定的時間間隔，以指定的優先順序進行處理。

當您建立定時器時，您可以指定要在方法第一次執行之前等候的時間量（到期時間），以及後續執行之間等候的時間量（期間）。 Timer 類別的解析度與系統時鐘相同。這表示如果期間小於系統時鐘的解析度，則 TimerCallback 委派會以系統時鐘解析所定義的間隔執行，這在 Windows 7 和 Windows 8 系統上大約為 15 毫秒。您可以使用 Change 方法來變更到期時間和期間，或停用定時器。

注意

只要您使用 Timer，就必須保留其參考。如同任何 Managed 對象，當沒有任何參考時，Timer 會受到垃圾收集。 Timer 仍在作用中的事實不會防止收集它。

注意

所使用的系統時鐘是 GetTickCount所使用的相同時鐘，這不會受到 timeBeginPeriod 和 timeEndPeriod所做的變更影響。

當不再需要定時器時，請使用 Dispose 方法來釋放定時器所持有的資源。請注意，呼叫 Dispose() 方法多載之後，可能會發生回呼，因為定時器佇列會由線程集區線程執行。您可以使用 Dispose(WaitHandle) 方法多載等待所有回呼完成為止。

定時器所執行的回呼方法應該重新進入，因為它會在線程 ThreadPool 上呼叫。如果定時器間隔小於執行回呼所需的時間，或是所有線程集區線程都在使用中，而且回呼已排入佇列多次，則回呼可以在兩個線程集區線程上同時執行。

注意

System.Threading.Timer 是簡單的輕量型定時器，使用回呼方法，並由線程集區線程提供服務。不建議搭配 Windows Forms 使用，因為它的回呼不會發生在使用者介面線程上。 System.Windows.Forms.Timer 是搭配 Windows Forms 使用的較佳選擇。針對伺服器型定時器功能，您可以考慮使用 System.Timers.Timer，這會引發事件並具有其他功能。

建構函式

Timer(TimerCallback)	使用新建立的 Timer 物件做為狀態物件，使用無限期間和無限到期時間，初始化 Timer 類別的新實例。
Timer(TimerCallback, Object, Int32, Int32)	使用 32 位帶正負號的整數來指定時間間隔，初始化 `Timer` 類別的新實例。
Timer(TimerCallback, Object, Int64, Int64)	使用 64 位帶正負號的整數來測量時間間隔，初始化 `Timer` 類別的新實例。
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	使用 TimeSpan 值測量時間間隔，初始化 `Timer` 類別的新實例。
Timer(TimerCallback, Object, UInt32, UInt32)	使用 32 位無符號整數來測量時間間隔，初始化 `Timer` 類別的新實例。

屬性

ActiveCount

取得目前作用中的定時器數目。作用中的定時器會在未來某個時間點註冊為刻度，但尚未取消。

方法

Change(Int32, Int32)	使用32位帶正負號的整數來測量時間間隔，變更定時器方法調用之間的開始時間和間隔。
Change(Int64, Int64)	使用64位帶正負號的整數來測量時間間隔，變更定時器方法調用之間的開始時間和間隔。
Change(TimeSpan, TimeSpan)	使用 TimeSpan 值來測量時間間隔，變更定時器方法調用之間的開始時間和間隔。
Change(UInt32, UInt32)	使用 32 位無符號整數來測量時間間隔，變更定時器方法調用之間的開始時間和間隔。
CreateObjRef(Type)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Dispose()	釋放目前實例 Timer所使用的所有資源。
Dispose(WaitHandle)	釋放目前 Timer 實例所使用的所有資源，並在處置定時器時發出訊號。
DisposeAsync()	釋放目前實例 Timer所使用的所有資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	允許對象嘗試釋放資源，並在垃圾收集回收之前執行其他清除作業。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個實例存留期原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個實例的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 對象的淺層複本。 (繼承來源 MarshalByRefObject)
ToString()	傳回表示目前物件的字串。 (繼承來源 Object)

擴充方法

ConfigureAwait(IAsyncDisposable, Boolean)

設定如何執行從異步可處置專案傳回的工作等候。

適用於

執行緒安全性

此類型是安全線程。

共用方式為

Timer 類別

定義

範例

備註

建構函式

屬性

方法

擴充方法

適用於

執行緒安全性

另請參閱

其他資源