Timer コンストラクター

定義

名前空間:: System.Threading

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll, System.Threading.Timer.dll

アセンブリ:: System.Threading.Timer.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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` クラスの新しいインスタンスを初期化します。

Timer(TimerCallback)

新しく作成されたTimer オブジェクトを状態オブジェクトとして使用して、Timer クラスの新しいインスタンスを無限の期間と無限期限で初期化します。

public:
 Timer(System::Threading::TimerCallback ^ callback);

public Timer(System.Threading.TimerCallback callback);

new System.Threading.Timer : System.Threading.TimerCallback -> System.Threading.Timer

Public Sub New (callback As TimerCallback)

パラメーター

callback: TimerCallback

実行するメソッドを表す TimerCallback デリゲート。

例

次のコード例では、タイマー自体を状態オブジェクトとして使用して、新しいタイマーを作成します。タイマーを開始するには、 Change メソッドを使用します。タイマーコールバックが発生すると、状態オブジェクトを使用してタイマーがオフになります。

using System;
using System.Threading;

public class Example
{
    public static void Main()
    {
        // Create an instance of the Example class, and start two
        // timers.
        Example ex = new Example();
        ex.StartTimer(2000);
        ex.StartTimer(1000);

        Console.WriteLine("Press Enter to end the program.");
        Console.ReadLine();
    }

    public void StartTimer(int dueTime)
    {
        Timer t = new Timer(new TimerCallback(TimerProc));
        t.Change(dueTime, 0);
    }

    private void TimerProc(object state)
    {
        // The state object is the Timer object.
        Timer t = (Timer) state;
        t.Dispose();
        Console.WriteLine("The timer callback executes.");
    }
}

Imports System.Threading

Public Class Example
    Public Shared Sub Main()
        ' Create an instance of the Example class, and start two
        ' timers.
        Dim ex As New Example()
        ex.StartTimer(2000)
        ex.StartTimer(1000)

        Console.WriteLine("Press Enter to end the program.")
        Console.ReadLine()
    End Sub

    Public Sub StartTimer(ByVal dueTime As Integer)
        Dim t As New Timer(AddressOf TimerProc)
        t.Change(dueTime, 0)
    End Sub

    Private Sub TimerProc(ByVal state As Object)
        ' The state object is the Timer object.
        Dim t As Timer = CType(state, Timer)
        t.Dispose()
        Console.WriteLine("The timer callback executes.")
    End Sub
End Class

注釈

Timer オブジェクト自体を状態オブジェクトとして使用する場合は、このコンストラクターを呼び出します。タイマーを作成した後、 Change メソッドを使用して、間隔と期限を設定します。

このコンストラクターは、 Timer オブジェクトが状態オブジェクトに割り当てられる前に最初のコールバックが発生するのを防ぐために、最初のコールバックの前に期限切れ時間を指定し、コールバック間の無限間隔を指定します。

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

適用対象

Timer(TimerCallback, Object, Int32, Int32)

32 ビット符号付き整数を使用して時間間隔を指定して、 Timer クラスの新しいインスタンスを初期化します。

public:
 Timer(System::Threading::TimerCallback ^ callback, System::Object ^ state, int dueTime, int period);

public Timer(System.Threading.TimerCallback callback, object state, int dueTime, int period);

new System.Threading.Timer : System.Threading.TimerCallback * obj * int * int -> System.Threading.Timer

Public Sub New (callback As TimerCallback, state As Object, dueTime As Integer, period As Integer)

パラメーター

callback: TimerCallback

実行するメソッドを表す TimerCallback デリゲート。

state: Object

コールバックメソッドまたは nullによって使用される情報を含むオブジェクト。

dueTime: Int32

callbackが呼び出されるまでの遅延時間 (ミリ秒単位)。タイマーが開始されないようにするには、 Infinite を指定します。タイマーをすぐに開始するには、ゼロ (0) を指定します。

period: Int32

callbackの呼び出し間の時間間隔 (ミリ秒単位)。定期的なシグナリングを無効にする Infinite を指定します。

例外

ArgumentOutOfRangeException

dueTime または period パラメーターは負の値であり、Infiniteと等しくありません。

ArgumentNullException

callback パラメーターはnull。

例

次のコード例は、 TimerCallback デリゲートを作成し、 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.

注釈

callback パラメーターで指定されたデリゲートは、dueTimeが経過した後、その後、periodの時間間隔が経過するたびに 1 回呼び出されます。

dueTimeがゼロ (0) の場合、callbackはすぐに呼び出されます。 dueTimeがTimeout.Infiniteされている場合、callbackは呼び出されません。タイマーは無効になりますが、Change メソッドを呼び出すことによって再度有効にすることができます。

Timer クラスはシステムクロックと同じ解像度 (Windows 7 および Windows 8 システムでは約 15 ミリ秒) であるため、callback デリゲートは、システムクロックの解像度で定義された間隔で実行されます (period がシステムクロックの解像度より小さい場合)。 periodがゼロ (0) またはTimeout.Infiniteで、dueTimeがTimeout.Infiniteされていない場合、callbackは 1 回呼び出されます。タイマーの定期的な動作は無効になりますが、Change メソッドを使用して再度有効にすることができます。

Note

使用されるシステムクロックは、GetTickCount で使用されるのと同じクロックであり、 timeBeginPeriod と timeEndPeriod で行われた変更の影響を受けません。

こちらもご覧ください

タイマー

適用対象

Timer(TimerCallback, Object, Int64, Int64)

時間間隔を測定するために 64 ビット符号付き整数を使用して、 Timer クラスの新しいインスタンスを初期化します。

public:
 Timer(System::Threading::TimerCallback ^ callback, System::Object ^ state, long dueTime, long period);

public Timer(System.Threading.TimerCallback callback, object state, long dueTime, long period);

new System.Threading.Timer : System.Threading.TimerCallback * obj * int64 * int64 -> System.Threading.Timer

Public Sub New (callback As TimerCallback, state As Object, dueTime As Long, period As Long)

パラメーター

callback: TimerCallback

実行するメソッドを表す TimerCallback デリゲート。

state: Object

コールバックメソッドまたは nullによって使用される情報を含むオブジェクト。

dueTime: Int64

period: Int64

callbackの呼び出し間の時間間隔 (ミリ秒単位)。定期的なシグナリングを無効にする Infinite を指定します。

例外

ArgumentOutOfRangeException

dueTime または period パラメーターは負の値であり、Infiniteと等しくありません。

NotSupportedException

dueTime または period パラメーターが 4294967294 より大きい。

注釈

callback パラメーターで指定されたデリゲートは、dueTimeが経過した後、その後、periodの時間間隔が経過するたびに 1 回呼び出されます。

Timer クラスはシステムクロックと同じ解像度 (Windows 7 および Windows 8 システムでは約 15 ミリ秒) であるため、callback デリゲートは、システムクロックの解像度で定義された間隔で実行されます (period がシステムクロックの解像度より小さい場合)。

periodがゼロ (0) またはTimeout.Infiniteで、dueTimeがTimeout.Infiniteされていない場合、callbackは 1 回呼び出されます。タイマーの定期的な動作は無効になりますが、Change メソッドを使用して再度有効にすることができます。

Note

使用されるシステムクロックは、GetTickCount で使用されるのと同じクロックであり、 timeBeginPeriod と timeEndPeriod で行われた変更の影響を受けません。

こちらもご覧ください

タイマー

適用対象

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

TimeSpan値を使用して時間間隔を測定し、Timer クラスの新しいインスタンスを初期化します。

public:
 Timer(System::Threading::TimerCallback ^ callback, System::Object ^ state, TimeSpan dueTime, TimeSpan period);

public Timer(System.Threading.TimerCallback callback, object state, TimeSpan dueTime, TimeSpan period);

new System.Threading.Timer : System.Threading.TimerCallback * obj * TimeSpan * TimeSpan -> System.Threading.Timer

Public Sub New (callback As TimerCallback, state As Object, dueTime As TimeSpan, period As TimeSpan)

パラメーター

callback: TimerCallback

実行するメソッドを表すデリゲート。

state: Object

コールバックメソッドまたは nullによって使用される情報を含むオブジェクト。

dueTime: TimeSpan

callbackが呼び出されるまでの遅延時間。タイマーが開始されないようにするには、 InfiniteTimeSpan を指定します。タイマーをすぐに開始する Zero を指定します。

period: TimeSpan

callbackの呼び出し間の時間間隔。定期的なシグナリングを無効にする InfiniteTimeSpan を指定します。

例外

ArgumentOutOfRangeException

dueTimeまたはperiodの値のミリ秒数が負の値であり、Infiniteと等しくないか、Int32.MaxValue より大きい値です。

ArgumentNullException

callback パラメーターはnull。

例

次のコード例は、 TimerCallback デリゲートを作成し、 Timer クラスの新しいインスタンスを初期化する方法を示しています。

using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        AutoResetEvent autoEvent     = new AutoResetEvent(false);
        StatusChecker  statusChecker = new StatusChecker(10);

        // Create the delegate that invokes methods for the timer.
        TimerCallback timerDelegate = 
            new TimerCallback(statusChecker.CheckStatus);

        TimeSpan delayTime = new TimeSpan(0, 0, 1);
        TimeSpan intervalTime = new TimeSpan(0, 0, 0, 0, 250);

        // Create a timer that signals the delegate to invoke 
        // CheckStatus after one second, and every 1/4 second 
        // thereafter.
        Console.WriteLine("{0} Creating timer.\n", 
            DateTime.Now.ToString("h:mm:ss.fff"));
        Timer stateTimer = new Timer(
            timerDelegate, autoEvent, delayTime, intervalTime);

        // When autoEvent signals, change the period to every 
        // 1/2 second.
        autoEvent.WaitOne(5000, false);
        stateTimer.Change(new TimeSpan(0), 
            intervalTime + intervalTime);
        Console.WriteLine("\nChanging period.\n");

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

class StatusChecker
{
    int invokeCount, 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 Main.
            invokeCount  = 0;
            autoEvent.Set();
        }
    }
}

Imports System.Threading

Public Class TimerExample

    <MTAThread> _
    Shared Sub Main()
    
        Dim autoEvent As New AutoResetEvent(False)
        Dim statusChecker As New StatusChecker(10)

        ' Create the delegate that invokes methods for the timer.
        Dim timerDelegate As TimerCallback = _
            AddressOf statusChecker.CheckStatus

        Dim delayTime As New TimeSpan(0, 0, 1)
        Dim intervalTime As New TimeSpan(0, 0, 0, 0, 250)

        ' Create a timer that signals the delegate to invoke 
        ' CheckStatus after one second, and every 1/4 second 
        ' thereafter.
        Console.WriteLine("{0} Creating timer." & vbCrLf, _
            DateTime.Now.ToString("h:mm:ss.fff"))
        Dim stateTimer As Timer = New Timer( _
            timerDelegate, autoEvent, delayTime, intervalTime)

        ' When autoEvent signals, change the period to every 
        ' 1/2 second.
        autoEvent.WaitOne(5000, False)
        stateTimer.Change( _
            new TimeSpan(0), intervalTime.Add(intervalTime))
        Console.WriteLine(vbCrLf & "Changing period." & vbCrLf)

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

Public Class StatusChecker

    Dim invokeCount, maxCount As Integer 

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

    ' This method is called by the timer delegate.
    Sub CheckStatus(stateInfo As Object)
        Dim autoEvent As AutoResetEvent = _
            DirectCast(stateInfo, AutoResetEvent)
        invokeCount += 1
        Console.WriteLine("{0} Checking status {1,2}.", _
            DateTime.Now.ToString("h:mm:ss.fff"), _
            invokeCount.ToString())

        If invokeCount = maxCount Then
        
            ' Reset the counter and signal to stop the timer.
            invokeCount  = 0
            autoEvent.Set()
        End If
    End Sub

End Class

注釈

callback パラメーターで指定されたデリゲートは、dueTimeが経過した後、その後、periodの時間間隔が経過するたびに 1 回呼び出されます。

dueTimeがゼロ (0) の場合、callbackはすぐに呼び出されます。 dueTimeが負の 1 (-1) ミリ秒の場合、callbackは呼び出されません。タイマーは無効になりますが、Change メソッドを呼び出すことによって再度有効にすることができます。

Timer クラスはシステムクロックと同じ解像度 (Windows 7 および Windows 8 システムでは約 15 ミリ秒) であるため、callback デリゲートは、システムクロックの解像度で定義された間隔で実行されます (period がシステムクロックの解像度より小さい場合)。 periodがゼロ (0) または負の 1 (-1) ミリ秒で、dueTimeが正の場合、callbackは 1 回呼び出されます。タイマーの定期的な動作は無効になりますが、Changeメソッドを使用して再度有効にすることができます。

Note

使用されるシステムクロックは、GetTickCount で使用されるのと同じクロックであり、 timeBeginPeriod と timeEndPeriod で行われた変更の影響を受けません。

こちらもご覧ください

タイマー

適用対象

Timer(TimerCallback, Object, UInt32, UInt32)

重要

この API は CLS 準拠ではありません。

32 ビット符号なし整数を使用して時間間隔を測定して、 Timer クラスの新しいインスタンスを初期化します。

public:
 Timer(System::Threading::TimerCallback ^ callback, System::Object ^ state, System::UInt32 dueTime, System::UInt32 period);

[System.CLSCompliant(false)]
public Timer(System.Threading.TimerCallback callback, object state, uint dueTime, uint period);

[<System.CLSCompliant(false)>]
new System.Threading.Timer : System.Threading.TimerCallback * obj * uint32 * uint32 -> System.Threading.Timer

Public Sub New (callback As TimerCallback, state As Object, dueTime As UInteger, period As UInteger)

パラメーター

callback: TimerCallback

実行するメソッドを表すデリゲート。

state: Object

コールバックメソッドまたは nullによって使用される情報を含むオブジェクト。

dueTime: UInt32

period: UInt32

callbackの呼び出し間の時間間隔 (ミリ秒単位)。定期的なシグナリングを無効にする Infinite を指定します。

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

dueTime または period パラメーターは負の値であり、Infiniteと等しくありません。

ArgumentNullException

callback パラメーターはnull。

注釈

callback パラメーターで指定されたデリゲートは、dueTimeが経過した後、その後、periodの時間間隔が経過するたびに 1 回呼び出されます。

Note

使用されるシステムクロックは、GetTickCount で使用されるのと同じクロックであり、 timeBeginPeriod と timeEndPeriod で行われた変更の影響を受けません。

こちらもご覧ください

タイマー

適用対象

フィードバック

このページはお役に立ちましたか?