Timer.Elapsed Timer.Elapsed Timer.Elapsed Timer.Elapsed Event

Definition

Tritt ein, wenn das Intervall abläuft.Occurs when the interval elapses.

public:
 event System::Timers::ElapsedEventHandler ^ Elapsed;
[System.Timers.TimersDescription("Occurs when the Interval has elapsed.")]
[System.Timers.TimersDescription("TimerIntervalElapsed")]
public event System.Timers.ElapsedEventHandler Elapsed;
member this.Elapsed : System.Timers.ElapsedEventHandler 
Public Custom Event Elapsed As ElapsedEventHandler 
Attribute

Beispiele

Das folgende Beispiel instanziiert ein Timer-Objekt, das sein Timer.Elapsed-Ereignis alle zwei Sekunden (2000 Millisekunden) auslöst, einen Ereignishandler für das Ereignis einrichtet und den Timer startet.The following example instantiates a Timer object that fires its Timer.Elapsed event every two seconds (2000 milliseconds), sets up an event handler for the event, and starts the timer. Der Ereignishandler zeigt den Wert der ElapsedEventArgs.SignalTime-Eigenschaft bei jedem Auslösen an.The event handler displays the value of the ElapsedEventArgs.SignalTime property each time it is raised.

using namespace System;
using namespace System::Timers;

public ref class Example
{
private:
    static System::Timers::Timer^ aTimer;

public:
    static void Demo()
    {
        // Create a timer and set a two second interval.
        aTimer = gcnew System::Timers::Timer();
        aTimer->Interval = 2000;

        // Hook up the Elapsed event for the timer. 
        aTimer->Elapsed += gcnew System::Timers::ElapsedEventHandler(Example::OnTimedEvent);

        // Have the timer fire repeated events (true is the default)
        aTimer->AutoReset = true;

        // Start the timer
        aTimer->Enabled = true;

        Console::WriteLine("Press the Enter key to exit the program at any time... ");
        Console::ReadLine();
    }

private:
    static void OnTimedEvent(Object^ source, System::Timers::ElapsedEventArgs^ e)
    {
        Console::WriteLine("The Elapsed event was raised at {0}", e->SignalTime);
    }
};

int main()
{
    Example::Demo();
}
// The example displays output like the following: 
//       Press the Enter key to exit the program at any time... 
//       The Elapsed event was raised at 5/20/2015 8:48:58 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:00 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:02 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:04 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:06 PM 

using System;
using System.Timers;

public class Example
{
    private static Timer aTimer;

    public static void Main()
    {
        // Create a timer and set a two second interval.
        aTimer = new System.Timers.Timer();
        aTimer.Interval = 2000;

        // Hook up the Elapsed event for the timer. 
        aTimer.Elapsed += OnTimedEvent;

        // Have the timer fire repeated events (true is the default)
        aTimer.AutoReset = true;

        // Start the timer
        aTimer.Enabled = true;

        Console.WriteLine("Press the Enter key to exit the program at any time... ");
        Console.ReadLine();
    }

    private static void OnTimedEvent(Object source, System.Timers.ElapsedEventArgs e)
    {
        Console.WriteLine("The Elapsed event was raised at {0}", e.SignalTime);
    }
}
// The example displays output like the following: 
//       Press the Enter key to exit the program at any time... 
//       The Elapsed event was raised at 5/20/2015 8:48:58 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:00 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:02 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:04 PM 
//       The Elapsed event was raised at 5/20/2015 8:49:06 PM 
Imports System.Timers

Public Module Example
    Private aTimer As Timer

    Public Sub Main()
        ' Create a timer and set a two second interval.
        aTimer = New System.Timers.Timer()
        aTimer.Interval = 2000

        ' Hook up the Elapsed event for the timer.  
        AddHandler aTimer.Elapsed, AddressOf OnTimedEvent

        ' Have the timer fire repeated events (true is the default)
        aTimer.AutoReset = True

        ' Start the timer
        aTimer.Enabled = True

        Console.WriteLine("Press the Enter key to exit the program at any time... ")
        Console.ReadLine()
    End Sub

    Private Sub OnTimedEvent(source As Object, e As System.Timers.ElapsedEventArgs)
        Console.WriteLine("The Elapsed event was raised at {0}", e.SignalTime)
    End Sub
End Module
' The example displays output like the following: 
'       Press the Enter key to exit the program at any time... 
'       The Elapsed event was raised at 5/20/2015 8:48:58 PM 
'       The Elapsed event was raised at 5/20/2015 8:49:00 PM 
'       The Elapsed event was raised at 5/20/2015 8:49:02 PM 
'       The Elapsed event was raised at 5/20/2015 8:49:04 PM 
'       The Elapsed event was raised at 5/20/2015 8:49:06 PM 

Hinweise

Das Elapsed true -Ereignis wird ausgelöst, Enabled wenn die-Eigenschaft und das von der Interval -Eigenschaft definierte Zeitintervall (in Millisekunden) abläuft.The Elapsed event is raised if the Enabled property is true and the time interval (in milliseconds) defined by the Interval property elapses. Wenn die AutoReset -Eigenschaft trueist, wird das-Ereignis in einem von der Interval -Eigenschaft definierten Intervall wiederholt ausgelöst. andernfalls wird das-Ereignis nur einmal ausgelöst, Interval wenn der Wert erstmalig abläuft.If the AutoReset property is true, the event is raised repeatedly at an interval defined by the Interval property; otherwise, the event is raised only once, the first time the Interval value elapses.

Wenn Interval festgelegt wird, Timer nachdem gestartet wurde, wird die Anzahl zurückgesetzt.If Interval is set after the Timer has started, the count is reset. Wenn Sie z. b. das Intervall auf 5 Sekunden festlegen und dann Enabled auf truefestlegen, wird die Anzahl zum Zeitpunkt Enabled der Festlegung von gestartet.For example, if you set the interval to 5 seconds and then set Enabled to true, the count starts at the time Enabled is set. Wenn Sie das Intervall auf 10 Sekunden zurücksetzen, wenn die Anzahl 3 Sekunden Elapsed beträgt, wird das-Ereignis zum ersten Mal ausgelöst Enabled , nachdem auf truefestgelegt wurde.If you reset the interval to 10 seconds when count is 3 seconds, the Elapsed event is raised for the first time 13 seconds after Enabled was set to true.

Wenn die SynchronizingObject -Eigenschaft nullist, Elapsed wird das-Ereignis in ThreadPool einem Thread ausgelöst.If the SynchronizingObject property is null,the Elapsed event is raised on a ThreadPool thread. Wenn die Verarbeitung des Elapsed Ereignisses länger als Intervaldauert, wird das Ereignis möglicherweise erneut in einem anderen ThreadPool Thread ausgelöst.If the processing of the Elapsed event lasts longer than Interval, the event might be raised again on another ThreadPool thread. In dieser Situation muss der Ereignishandler eintrittsinvariant sein.In this situation, the event handler should be reentrant.

Hinweis

Die Ereignisbehandlungsmethode kann für einen Thread zur gleichen Zeit ausgeführt werden, zu der ein anderer Thread die Stop-Methode aufruft oder die Enabled-Eigenschaft auf false festlegt.The event-handling method might run on one thread at the same time that another thread calls the Stop method or sets the Enabled property to false. Dies kann dazu führen, dass das Elapsed-Ereignis ausgelöst wird, nachdem der Timer gestoppt wurde.This might result in the Elapsed event being raised after the timer is stopped. Der Beispielcode für die Stop-Methode zeigt eine Möglichkeit, diese Racebedingung zu vermeiden.The example code for the Stop method shows one way to avoid this race condition.

Auch wenn SynchronizingObject nicht null ist, können Elapsed-Ereignisse auftreten, wenn die Methoden Dispose oder Stop aufgerufen wurden oder die Enabled-Eigenschaft auf false festgelegt wurde, da das Signal zum Auslösen des Elapsed-Ereignisses für die Ausführung stets in die Warteschlange eines Threadpoolthreads eingereiht wird.Even if SynchronizingObject is not null, Elapsed events can occur after the Dispose or Stop method has been called or after the Enabled property has been set to false, because the signal to raise the Elapsed event is always queued for execution on a thread pool thread. Eine Möglichkeit, diese Racebedingung aufzulösen, besteht darin, ein Flag zu setzen, das den Ereignishandler für das Elapsed-Ereignis anweist, nachfolgende Ereignisse zu ignorieren.One way to resolve this race condition is to set a flag that tells the event handler for the Elapsed event to ignore subsequent events.

Die Timer-Komponente fängt alle Ausnahmen, die von Ereignishandlern für das Elapsed-Ereignis ausgelöst werden, ab und unterdrückt sie.The Timer component catches and suppresses all exceptions thrown by event handlers for the Elapsed event. Dieses Verhalten kann sich in zukünftigen .NET Framework-Versionen ändern.This behavior is subject to change in future releases of the .NET Framework.

Gilt für:

Siehe auch