HOWTO · Csharp
Timer zurücksetzen in C#
In diesem Artikel wird erläutert, wie Sie einen Timer mithilfe der Programmiersprache C# zurücksetzen.
Auf dieser Seite
Um das Timerintervall in C# zurückzusetzen, rufen Sie zuerst Stop() und dann Start() für einen System.Timers.Timer auf. Der Typ besitzt keine Methode Reset(). Legen Sie AutoReset danach fest, ob Sie ein einzelnes oder wiederholte abgelaufene Ereignisse wünschen; diese Eigenschaft startet einen laufenden Countdown nicht auf Anforderung neu.
Welches Timerverhalten in C# benötigen Sie?
Verwenden Sie einen einmaligen Timer, wenn ein Vorgang nach einer Verzögerung genau einmal ausgeführt werden soll oder Ihr Code das nächste Intervall ausdrücklich planen soll. Setzen Sie AutoReset auf false und verwenden Sie Stop() und Start(), wenn Sie ein neues Intervall beginnen möchten. Für wiederkehrende Aufgaben setzen Sie AutoReset auf true, damit der Timer nach jedem Intervall Elapsed auslöst.
Wenn ein Timer bereits läuft und Sie sein nächstes Ereignis verzögern möchten, stoppen und starten Sie ihn erneut. Das Starten eines bereits aktivierten Timers bietet keine separate Zurücksetzfunktion. Legen Sie das Intervall in Millisekunden fest und wählen Sie eine positive Dauer, die zur Aufgabe passt. Ein Timer dient zum Planen von Rückrufen, nicht zum präzisen Messen verstrichener Zeit.
Wie System.Timers.Timer abgelaufene Ereignisse behandelt
System.Timers.Timer löst sein Elapsed-Ereignis nach dem konfigurierten Interval aus. Enabled gibt an, ob der Timer läuft; Start() aktiviert ihn und Stop() deaktiviert ihn. Der Ereignishandler erhält einen Wert vom Typ ElapsedEventArgs, der den Signalzeitpunkt enthält. Handler werden asynchron ausgeführt und können sich daher überschneiden, wenn eine wiederkehrende Aufgabe länger als das Intervall dauert. Schützen Sie gemeinsam genutzte Daten und gehen Sie nicht davon aus, dass der Rückruf im UI-Thread ausgeführt wird.
AutoReset ist eine boolesche Eigenschaft. Bei true plant der Timer weitere abgelaufene Ereignisse im festgelegten Intervall. Bei false löst er ein Ereignis aus und hält dann an. Die Eigenschaft steuert die Wiederholung; sie ist kein Befehl, den aktuellen Countdown neu zu starten. Wenn ein einmaliger Timer ein weiteres Intervall ausführen soll, rufen Sie nach der Ereignisbehandlung ausdrücklich erneut Start() auf.
Einen einmaligen Timer mit Stop und Start neu starten
Rufen Sie bei einem laufenden einmaligen Timer Stop() auf, um den anstehenden Ablauf abzubrechen, und anschließend Start(), um ein neues Intervall zu beginnen. Das ist die praktische Methode zum Zurücksetzen. Hat der Timer sein Ereignis bereits ausgelöst, während AutoReset auf false steht, rufen Sie Start() auf, um ein weiteres Intervall zu planen. Legen Sie AutoReset vor dem Start fest, damit das gewünschte Verhalten von Anfang an klar ist.
Denken Sie daran, dass Timer-Rückrufe asynchron ausgeführt werden. Wenn ein anderer Teil des Programms den Timer anhält, kann ein Rückruf bereits in der Warteschlange stehen. Koordinieren Sie daher bei Bedarf das Beenden und den Zugriff auf gemeinsam genutzte Daten. Halten Sie den Handler kurz oder verlagern Sie längere Aufgaben in einen kontrollierten Worker, damit sich wiederkehrende Ticks nicht mit noch laufenden Aufgaben überschneiden.
AutoReset für wiederkehrende Intervalle verwenden
Setzen Sie AutoReset = true für ein wiederkehrendes Intervall, etwa beim Abrufen oder regelmäßigen Aktualisieren eines Werts. Jedes abgelaufene Ereignis wird entsprechend dem Timerintervall geplant. Setzen Sie die Eigenschaft auf false, wenn Sie ein Ereignis benötigen und selbst festlegen möchten, wann das nächste Intervall beginnt. Keine der beiden Einstellungen stellt einen Countdownwert bereit oder ändert das Intervall eines bereits geplanten Ticks unmittelbar. Stoppen und starten Sie den Timer, um ein neues Intervall zu planen.
Verwenden Sie einen wiederkehrenden Timer nicht als präzise Uhr. Die Planung kann sich durch die Auslastung des Threadpools verzögern, und der Rückruf beginnt möglicherweise nicht genau nach der angeforderten Millisekunde. Muss jeder Vorgang abgeschlossen sein, bevor der nächste beginnt, planen Sie nach Abschluss des Vorgangs ein einmaliges Intervall oder synchronisieren Sie die Arbeit.
Den Timer sicher anhalten und freigeben
Rufen Sie Stop() auf, wenn der Timer keine Ereignisse mehr planen soll. Wenn der Vorgang, dem der Timer gehört, abgeschlossen ist, rufen Sie Dispose() auf, um seine Ressourcen freizugeben. Anhalten und Freigeben erfüllen unterschiedliche Aufgaben: Stop() beendet die aktive Planung, während Dispose() die Lebensdauer des Timers beendet. Starten Sie einen freigegebenen Timer nicht erneut. Erstellen Sie eine neue Instanz, wenn ein weiterer Vorgang einen Timer benötigt.
Da Elapsed asynchron ausgeführt wird, sorgt das Anhalten eines Timers nicht dafür, dass ein bereits laufender Handler verschwindet. Wenn das Herunterfahren auf einen Rückruf warten muss, koordinieren Sie sich mit diesem Handler über einen für die Anwendung geeigneten Synchronisierungsmechanismus. Halten Sie den Timer so lange am Leben, wie sein Handler ihn noch verwenden könnte, und heben Sie Ereignisabonnements auf, wenn ein länger lebender Timer sie nicht mehr benötigt.
Vollständiges Beispiel: Einen einmaligen Timer neu starten
Dieses vollständige Beispiel löst nach zwei Sekunden ein Ereignis aus, startet im Handler ein neues Intervall und beendet sich nach dem zweiten Ereignis. Mit AutoReset = false wird jedes Ereignis einmalig ausgelöst; Stop() und Start() planen das zweite Intervall ausdrücklich. Das Abschlusssignal ermöglicht es Main, vor der Bereinigung auf beide Rückrufe zu warten.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
using System;
using System.Threading;
using System.Timers;
class TimerRestartExample
{
static void Main()
{
using (var completed = new ManualResetEventSlim())
using (var timer = new System.Timers.Timer(2000))
{
int eventCount = 0;
timer.AutoReset = false;
timer.Elapsed += (sender, args) =>
{
eventCount++;
Console.WriteLine("Elapsed event " + eventCount);
if (eventCount == 1)
{
timer.Stop();
timer.Start();
}
else
{
completed.Set();
}
};
timer.Start();
completed.Wait();
timer.Stop();
}
}
}
Elapsed event 1
Elapsed event 2
Der bereitgestellte Laufzeittest wurde erfolgreich abgeschlossen und gab beide oben gezeigten abgelaufenen Ereignisse aus. Wählen Sie in einer Anwendung ein Intervall und eine Abschlussstrategie, die zu ihrer Lebensdauer passen. Ein Dienst oder eine Benutzeroberfläche kann nach einem Timerereignis weiterlaufen, statt wie in dieser Demonstration zu warten und sich zu beenden.