Timer クラス

定義

public ref class Timer sealed : IDisposable

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

public ref class Timer sealed : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class Timer sealed : MarshalByRefObject, IDisposable

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

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

public sealed class Timer : MarshalByRefObject, IAsyncDisposable, IDisposable

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
    interface ITimer

type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

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 ITimer

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IDisposable

継承

Object

Timer

継承

Object

MarshalByRefObject

Timer

属性

ComVisibleAttribute

実装

IDisposable IAsyncDisposable ITimer

例

次の例では、StatusChecker デリゲートと同じシグネチャを持つCheckStatus メソッドを含むTimerCallback クラスを定義します。 state メソッドのCheckStatus引数は、アプリケーション スレッドとコールバック デリゲートを実行するスレッド プール スレッドの同期に使用されるAutoResetEvent オブジェクトです。 StatusChecker クラスには、次の 2 つの状態変数も含まれています。

invokeCount
コールバック メソッドが呼び出された回数を示します。

maxCount
コールバック メソッドを呼び出す最大回数を決定します。

アプリケーション スレッドはタイマーを作成します。タイマーは 1 秒待機し、250 ミリ秒ごとに CheckStatus コールバック メソッドを実行します。 その後、アプリケーション スレッドは、 AutoResetEvent オブジェクトが通知されるまでブロックします。 CheckStatusコールバック メソッドは、maxCount回実行すると、AutoResetEvent.Set メソッドを呼び出して、AutoResetEvent オブジェクトの状態を signaled に設定します。 これが初めて発生すると、アプリケーション スレッドは Change(Int32, Int32) メソッドを呼び出して、コールバック メソッドが 5 分の 1 秒ごとに実行されるようにします。 AutoResetEvent オブジェクトが通知されるまで、もう一度ブロックします。 この場合、タイマーは Dispose メソッドを呼び出して破棄され、アプリケーションは終了します。

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)

Sub TimerCallback(state As Object)

タイマー デリゲートは、タイマーが構築されるときに指定され、変更できません。 このメソッドは、タイマーを作成したスレッドでは実行されません。システムによって提供される ThreadPool スレッドで実行されます。

タイマーを作成するときに、メソッドの最初の実行までの待機時間 (期限) と、後続の実行 (期間) の間に待機する時間を指定できます。 Timer クラスの解像度は、システム クロックと同じです。 つまり、期間がシステム クロックの解像度より小さい場合、TimerCallback デリゲートは、システム クロックの解像度によって定義された間隔 (Windows 7 およびWindows 8 システムでは約 15 ミリ秒) で実行されます。 Changeメソッドを使用して、期限と期間を変更したり、タイマーを無効にしたりできます。

タイマーが不要になったら、 Dispose メソッドを使用して、タイマーによって保持されているリソースを解放します。 タイマーはスレッド プール スレッドによる実行のコールバックをキューに入れるので、 Dispose() メソッドのオーバーロードが呼び出された後にコールバックが発生する可能性があることに注意してください。 Dispose(WaitHandle) メソッドのオーバーロードを使用して、すべてのコールバックが完了するまで待機できます。

タイマーによって実行されるコールバック メソッドは、 ThreadPool スレッドで呼び出されるため、再入可能である必要があります。 タイマー間隔がコールバックの実行に必要な時間より短い場合、またはすべてのスレッド プール スレッドが使用中でコールバックが複数回キューに登録されている場合、コールバックは 2 つのスレッド プール スレッドで同時に実行できます。

スレッド セーフ

この型はスレッド セーフです。

こちらもご覧ください

• TimerCallback
• タイマー
• マネージド スレッド プール