Timer Konstruktoren

Definition

Namespace:

System.Threading

Assembly:

System.Runtime.dll

Initialisiert eine neue Instanz der Timer-Klasse.

Überlädt

Timer(TimerCallback)	Initialisiert eine neue Instanz der Timer-Klasse mit einem unendlichen Zeitraum und einer unendlichen Vorlaufzeit, wobei das neu erstellte Timer-Objekt als Zustandsobjekt verwendet wird.
Timer(TimerCallback, Object, Int32, Int32)	Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung einer 32-Bit-Ganzzahl mit Vorzeichen zum Angeben des Zeitintervalls.
Timer(TimerCallback, Object, Int64, Int64)	Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von 64-Bit-Ganzzahlen mit Vorzeichen zum Messen von Zeitintervallen.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von TimeSpan-Werten zum Messen von Zeitintervallen.
Timer(TimerCallback, Object, UInt32, UInt32)	Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von 32-Bit-Ganzzahlen ohne Vorzeichen zum Messen von Zeitintervallen.

Timer(TimerCallback)

Quelle:

Timer.cs

Initialisiert eine neue Instanz der Timer-Klasse mit einem unendlichen Zeitraum und einer unendlichen Vorlaufzeit, wobei das neu erstellte Timer-Objekt als Zustandsobjekt verwendet wird.

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)

Parameter

callback

TimerCallback

Ein TimerCallback-Delegat, der die auszuführende Methode darstellt.

Beispiele

Im folgenden Codebeispiel wird ein neuer Timer erstellt, wobei der Timer selbst als Zustandsobjekt verwendet wird. Die Change -Methode wird verwendet, um den Timer zu starten. Wenn der Timerrückruf erfolgt, wird das Zustandsobjekt verwendet, um den Timer zu deaktivieren.

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

Hinweise

Rufen Sie diesen Konstruktor auf, wenn Sie das Timer Objekt selbst als Zustandsobjekt verwenden möchten. Nachdem Sie den Timer erstellt haben, verwenden Sie die Change -Methode, um das Intervall und die Fälligkeitszeit festzulegen.

Dieser Konstruktor gibt eine unendliche fällige Zeit vor dem ersten Rückruf und ein unendliches Intervall zwischen Rückrufen an, um zu verhindern, dass der erste Rückruf erfolgt, bevor das Timer Objekt dem Zustandsobjekt zugewiesen wird.

Die für callback angegebene Methode sollte erneut verwendet werden, da sie für ThreadPool Threads aufgerufen wird. Die -Methode kann gleichzeitig in zwei Threadpoolthreads ausgeführt werden, wenn das Zeitgeberintervall kleiner als die zum Ausführen der Methode erforderliche Zeit ist oder wenn alle Threadpoolthreads verwendet werden und die Methode mehrmals in die Warteschlange eingereiht wird.

Timer(TimerCallback, Object, Int32, Int32)

Quelle:

Timer.cs

Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung einer 32-Bit-Ganzzahl mit Vorzeichen zum Angeben des Zeitintervalls.

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)

Parameter

callback

TimerCallback

Ein TimerCallback-Delegat, der die auszuführende Methode darstellt.

state

Object

Ein Objekt, das die von der Rückrufmethode zu verwendenden Informationen enthält, oder null.

dueTime

Int32

Die in Millisekunden angegebene Zeitspanne, die gewartet werden soll, bis callback aufgerufen wird. Geben Sie Infinite an, um das Starten des Zeitgebers zu verhindern. Geben Sie 0 (null) an, um den Timer sofort zu starten.

period

Int32

Das in Millisekunden angegebene Zeitintervall zwischen den Aufrufen von callback. Geben Sie Infinite an, um periodisches Signalisieren zu deaktivieren.

Ausnahmen

ArgumentOutOfRangeException

Der dueTime-Parameter oder der period-Parameter ist negativ und ungleich Infinite.

ArgumentNullException

Der callback-Parameter ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen TimerCallback Delegaten erstellen und eine neue instance der Timer -Klasse initialisieren.

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.

Hinweise

Der durch den callback Parameter angegebene Delegat wird einmal aufgerufen, nachdem dueTime er verstrichen ist, und danach jedes Mal, wenn das period Zeitintervall verstrichen ist.

Wenn dueTime null (0) ist, callback wird sofort aufgerufen. Wenn dueTime ist Timeout.Infinite, callback wird nicht aufgerufen. Der Timer ist deaktiviert, kann aber durch Aufrufen der Change -Methode erneut aktiviert werden.

Da die Timer -Klasse die gleiche Auflösung wie die Systemuhr hat, die auf Windows 7- und Windows 8-Systemen ungefähr 15 Millisekunden beträgt, wird der callback Delegat in Intervallen ausgeführt, die durch die Auflösung der Systemuhr definiert werden, wenn period kleiner als die Auflösung der Systemuhr ist. Wenn period null (0) oder Timeout.Infinite und dueTime nicht Timeout.Infiniteist, callback wird einmal aufgerufen. Das periodische Verhalten des Timers ist deaktiviert, kann jedoch mithilfe der Change -Methode erneut aktiviert werden.

Hinweis

Die verwendete Systemuhr ist die gleiche Uhr, die von GetTickCount verwendet wird, die nicht von Änderungen betroffen ist, die mit timeBeginPeriod und timeEndPeriod vorgenommen wurden.

Die für callback angegebene Methode sollte erneut verwendet werden, da sie für ThreadPool Threads aufgerufen wird. Die -Methode kann gleichzeitig in zwei Threadpoolthreads ausgeführt werden, wenn das Zeitgeberintervall kleiner als die zum Ausführen der Methode erforderliche Zeit ist oder wenn alle Threadpoolthreads verwendet werden und die Methode mehrmals in die Warteschlange eingereiht wird.

Weitere Informationen

• Timer

Timer(TimerCallback, Object, Int64, Int64)

Quelle:

Timer.cs

Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von 64-Bit-Ganzzahlen mit Vorzeichen zum Messen von Zeitintervallen.

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)

Parameter

callback

TimerCallback

Ein TimerCallback-Delegat, der die auszuführende Methode darstellt.

state

Object

Ein Objekt, das die von der Rückrufmethode zu verwendenden Informationen enthält, oder null.

dueTime

Int64

Die in Millisekunden angegebene Zeitspanne, die gewartet werden soll, bis callback aufgerufen wird. Geben Sie Infinite an, um das Starten des Zeitgebers zu verhindern. Geben Sie 0 (null) an, um den Timer sofort zu starten.

period

Int64

Das in Millisekunden angegebene Zeitintervall zwischen den Aufrufen von callback. Geben Sie Infinite an, um periodisches Signalisieren zu deaktivieren.

Ausnahmen

ArgumentOutOfRangeException

Der dueTime-Parameter oder der period-Parameter ist negativ und ungleich Infinite.

NotSupportedException

Der dueTime-Parameter oder der period-Parameter ist größer als 4.294.967.294.

Hinweise

Der durch den callback Parameter angegebene Delegat wird einmal aufgerufen, nachdem dueTime er verstrichen ist, und danach jedes Mal, wenn das period Zeitintervall verstrichen ist.

Wenn dueTime null (0) ist, callback wird sofort aufgerufen. Wenn dueTime ist Timeout.Infinite, callback wird nicht aufgerufen. Der Timer ist deaktiviert, kann aber durch Aufrufen der Change -Methode erneut aktiviert werden.

Da die Timer -Klasse die gleiche Auflösung wie die Systemuhr hat, die auf Windows 7- und Windows 8-Systemen ungefähr 15 Millisekunden beträgt, wird der callback Delegat in Intervallen ausgeführt, die durch die Auflösung der Systemuhr definiert werden, wenn period kleiner als die Auflösung der Systemuhr ist. Wenn period null (0) oder Timeout.Infinite und dueTime nicht Timeout.Infiniteist, callback wird einmal aufgerufen. Das periodische Verhalten des Timers ist deaktiviert, kann jedoch mithilfe der Change -Methode erneut aktiviert werden.

Hinweis

Die verwendete Systemuhr ist die gleiche Uhr, die von GetTickCount verwendet wird, die nicht von Änderungen betroffen ist, die mit timeBeginPeriod und timeEndPeriod vorgenommen wurden.

Die für callback angegebene Methode sollte erneut verwendet werden, da sie für ThreadPool Threads aufgerufen wird. Die -Methode kann gleichzeitig in zwei Threadpoolthreads ausgeführt werden, wenn das Zeitgeberintervall kleiner als die zum Ausführen der Methode erforderliche Zeit ist oder wenn alle Threadpoolthreads verwendet werden und die Methode mehrmals in die Warteschlange eingereiht wird.

Weitere Informationen

• Timer

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Quelle:

Timer.cs

Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von TimeSpan-Werten zum Messen von Zeitintervallen.

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)

Parameter

callback

TimerCallback

Ein Delegat, der eine auszuführende Methode darstellt.

state

Object

Ein Objekt, das die von der Rückrufmethode zu verwendenden Informationen enthält, oder null.

dueTime

TimeSpan

Die Zeitspanne für die Verzögerung, bevor der callback aufgerufen wird. Geben Sie InfiniteTimeSpan an, um das Starten des Zeitgebers zu verhindern. Geben Sie Zero an, um den Timer sofort zu starten.

period

TimeSpan

Das Zeitintervall zwischen den Aufrufen von callback. Geben Sie InfiniteTimeSpan an, um periodisches Signalisieren zu deaktivieren.

Ausnahmen

ArgumentOutOfRangeException

Die Anzahl der Millisekunden im Wert von dueTime oder period ist negativ und nicht gleich Infinite, oder ist größer als Int32.MaxValue.

ArgumentNullException

Der callback-Parameter ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen TimerCallback Delegaten erstellen und eine neue instance der Timer -Klasse initialisieren.

using namespace System;
using namespace System::Threading;
ref class StatusChecker
{
private:
   int invokeCount;
   int 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} 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();
      }
   }

};

int main()
{
   AutoResetEvent^ autoEvent = gcnew AutoResetEvent( false );
   StatusChecker^ statusChecker = gcnew StatusChecker( 10 );
   
   // Create the delegate that invokes methods for the timer.
   TimerCallback^ timerDelegate = gcnew TimerCallback( statusChecker, &StatusChecker::CheckStatus );
   TimeSpan delayTime = TimeSpan(0,0,1);
   TimeSpan intervalTime = 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 = gcnew Timer( timerDelegate,autoEvent,delayTime,intervalTime );
   
   // When autoEvent signals, change the period to every 1/2 second.
   autoEvent->WaitOne( 5000, false );
   stateTimer->Change( TimeSpan(0), intervalTime + intervalTime );
   Console::WriteLine( "\nChanging period.\n" );
   
   // When autoEvent signals the second time, dispose of the timer.
   autoEvent->WaitOne( 5000, false );
   stateTimer->~Timer();
   Console::WriteLine( "\nDestroying 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

Hinweise

Der durch den callback Parameter angegebene Delegat wird einmal aufgerufen, nachdem dueTime er verstrichen ist, und danach jedes Mal, wenn das period Zeitintervall verstrichen ist.

Wenn dueTime null (0) ist, callback wird sofort aufgerufen. Wenn dueTime eine (-1) Millisekunde negativ ist, callback wird nicht aufgerufen. Der Timer ist deaktiviert, kann aber durch Aufrufen der Change -Methode erneut aktiviert werden.

Da die Timer -Klasse die gleiche Auflösung wie die Systemuhr hat, die auf Windows 7- und Windows 8-Systemen ungefähr 15 Millisekunden beträgt, wird der callback Delegat in Intervallen ausgeführt, die durch die Auflösung der Systemuhr definiert werden, wenn period kleiner als die Auflösung der Systemuhr ist. Wenn period null (0) oder negativ eine Millisekunde (-1) ist und dueTime positiv ist, callback wird einmal aufgerufen. Das periodische Verhalten des Timers ist deaktiviert, kann jedoch mithilfe der Change -Methode wieder aktiviert werden.

Hinweis

Die verwendete Systemuhr ist die gleiche Uhr, die von GetTickCount verwendet wird, die nicht von Änderungen betroffen ist, die mit timeBeginPeriod und timeEndPeriod vorgenommen wurden.

Die für callback angegebene Methode sollte erneut verwendet werden, da sie für ThreadPool Threads aufgerufen wird. Die -Methode kann gleichzeitig in zwei Threadpoolthreads ausgeführt werden, wenn das Zeitgeberintervall kleiner als die zum Ausführen der Methode erforderliche Zeit ist oder wenn alle Threadpoolthreads verwendet werden und die Methode mehrmals in die Warteschlange eingereiht wird.

Weitere Informationen

• Timer

Timer(TimerCallback, Object, UInt32, UInt32)

Quelle:

Timer.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der Timer-Klasse unter Verwendung von 32-Bit-Ganzzahlen ohne Vorzeichen zum Messen von Zeitintervallen.

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)

Parameter

callback

TimerCallback

Ein Delegat, der eine auszuführende Methode darstellt.

state

Object

Ein Objekt, das die von der Rückrufmethode zu verwendenden Informationen enthält, oder null.

dueTime

UInt32

Die in Millisekunden angegebene Zeitspanne, die gewartet werden soll, bis callback aufgerufen wird. Geben Sie Infinite an, um das Starten des Zeitgebers zu verhindern. Geben Sie 0 (null) an, um den Timer sofort zu starten.

period

UInt32

Das in Millisekunden angegebene Zeitintervall zwischen den Aufrufen von callback. Geben Sie Infinite an, um periodisches Signalisieren zu deaktivieren.

Attribute

CLSCompliantAttribute

Ausnahmen

ArgumentOutOfRangeException

Der dueTime-Parameter oder der period-Parameter ist negativ und ungleich Infinite.

ArgumentNullException

Der callback-Parameter ist null.

Hinweise

Der durch den callback Parameter angegebene Delegat wird einmal aufgerufen, nachdem dueTime er verstrichen ist, und danach jedes Mal, wenn das period Zeitintervall verstrichen ist.

Wenn dueTime null (0) ist, callback wird sofort aufgerufen. Wenn dueTime ist Timeout.Infinite, callback wird nicht aufgerufen. Der Timer ist deaktiviert, kann aber durch Aufrufen der Change -Methode erneut aktiviert werden.

Da die Timer -Klasse die gleiche Auflösung wie die Systemuhr hat, die auf Windows 7- und Windows 8-Systemen ungefähr 15 Millisekunden beträgt, wird der callback Delegat in Intervallen ausgeführt, die durch die Auflösung der Systemuhr definiert werden, wenn period kleiner als die Auflösung der Systemuhr ist. Wenn period null (0) oder Timeout.Infinite und dueTime nicht Timeout.Infiniteist, callback wird einmal aufgerufen. Das periodische Verhalten des Timers ist deaktiviert, kann jedoch mithilfe der Change -Methode erneut aktiviert werden.

Hinweis

Die verwendete Systemuhr ist die gleiche Uhr, die von GetTickCount verwendet wird, die nicht von Änderungen betroffen ist, die mit timeBeginPeriod und timeEndPeriod vorgenommen wurden.

Die für callback angegebene Methode sollte erneut verwendet werden, da sie für ThreadPool Threads aufgerufen wird. Die -Methode kann gleichzeitig in zwei Threadpoolthreads ausgeführt werden, wenn das Zeitgeberintervall kleiner als die zum Ausführen der Methode erforderliche Zeit ist oder wenn alle Threadpoolthreads verwendet werden und die Methode mehrmals in die Warteschlange eingereiht wird.

Weitere Informationen

• Timer