TimerCallback デリゲート
Timer からの呼び出しを処理するメソッドを表します。
<Serializable>
Public Delegate Sub TimerCallback( _ ByVal state As Object _)
[C#]
[Serializable]
public delegate void TimerCallback( object state);
[C++]
[Serializable]
public __gc __delegate void TimerCallback( Object* state);
[JScript] JScript では、.NET Framework のデリゲートを利用することができます。ただし、独自に定義することはできません。
パラメータ [Visual Basic, C#, C++]
コールバック メソッドの宣言のパラメータは、TimerCallback デリゲートの宣言と同じでなければなりません。
- state
このデリゲートで呼び出されたメソッドに関連するアプリケーション固有の情報を格納するオブジェクト、または null 参照 (Visual Basic では Nothing) 。
解説
TimerCallback デリゲートを使用して、 Timer で呼び出されるメソッドを指定します。このメソッドは、タイマを作成したスレッドで実行されず、システムが提供する個別のスレッド プール スレッドで実行されます。 TimerCallback デリゲートは、開始時刻が経過すると一度メソッドを呼び出し、 Dispose メソッドが呼び出されるか、時間間隔の値 Infinite で Timer.Change が呼び出されるまで、タイマの時間間隔が経過するごとにメソッドを呼び出し続けます。
タイマ デリゲートは、タイマの構築時に指定され、変更することはできません。 Timer の開始時刻は、 Timer コンストラクタの dueTime パラメータに渡され、期間は period パラメータに渡されます。 TimerCallback デリゲートを作成および使用例については、 System.Threading.Timer のトピックを参照してください。
使用例
[Visual Basic, C#, C++] Timer クラスで使用するデリゲートを作成する例を次に示します。
Imports Microsoft.VisualBasic
Imports System
Imports System.Threading
Public Class TimerExample
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
' 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, 1000, 250)
' When autoEvent signals, change the period to every
' 1/2 second.
autoEvent.WaitOne(5000, False)
stateTimer.Change(0, 500)
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
[C#]
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);
// 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, 1000, 250);
// When autoEvent signals, change the period to every
// 1/2 second.
autoEvent.WaitOne(5000, false);
stateTimer.Change(0, 500);
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();
}
}
}
[C++]
#using <mscorlib.dll>
using namespace System;
using namespace System::Threading;
__gc class StatusChecker
{
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(S"{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();
}
}
};
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, &StatusChecker::CheckStatus);
// Create a timer that signals the delegate to invoke CheckStatus
// after one second, and every 1/4 second thereafter.
Console::WriteLine(S"{0} Creating timer.\n",
DateTime::Now.ToString("h:mm:ss.fff"));
Timer* stateTimer =
new Timer(timerDelegate, autoEvent, 1000, 250);
// When autoEvent signals, change the period to every 1/2 second.
autoEvent->WaitOne(5000, false);
stateTimer->Change(0, 500);
Console::WriteLine(S"\nChanging period.\n");
// When autoEvent signals the second time, dispose of the timer.
autoEvent->WaitOne(5000, false);
stateTimer->Dispose();
Console::WriteLine(S"\nDestroying timer.");
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Threading
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: Mscorlib (Mscorlib.dll 内)