Timer.Enabled Eigenschaft

Definition

Namespace:

System.Timers

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Quelle:

Timer.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das TimerElapsed Ereignis ausgelöst werden soll.

public:
 property bool Enabled { bool get(); void set(bool value); };

public bool Enabled { get; set; }

member this.Enabled : bool with get, set

Public Property Enabled As Boolean

Eigenschaftswert

Boolean

truewenn das Timer Ereignis ausgelöst Elapsed werden soll; andernfalls . false Der Standardwert lautet false.

Ausnahmen

ObjectDisposedException

Diese Eigenschaft kann nicht festgelegt werden, da der Timer verworfen wurde.

ArgumentException

Die Interval Eigenschaft wurde auf einen Wert festgelegt, der größer als Int32.MaxValue ist, bevor der Timer aktiviert wurde.

Beispiele

Im folgenden Beispiel wird ein Timer Objekt instanziiert, das sein Timer.Elapsed Ereignis alle zwei Sekunden auslöst (2000 Millisekunden), einen Ereignishandler für das Ereignis einrichtet und den Timer startet. Der Ereignishandler zeigt den Wert der ElapsedEventArgs.SignalTime Eigenschaft jedes Mal an, wenn sie ausgelöst wird.

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

open System.Timers

let onTimedEvent source (e: ElapsedEventArgs) =
    printfn $"The Elapsed event was raised at {e.SignalTime}"

// Create a timer and set a two second interval.
let aTimer = new Timer()
aTimer.Interval <- 2000

// Hook up the Elapsed event for the timer. 
aTimer.Elapsed.AddHandler onTimedEvent

// Have the timer fire repeated events (true is the default)
aTimer.AutoReset <- true

// Start the timer
aTimer.Enabled <- true

printfn "Press the Enter key to exit the program at any time... "
stdin.ReadLine() |> ignore

// 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

Die Einstellung Enabled ist identisch mit dem AufrufenStart, während die Einstellung falseEnabled mit dem Aufrufen Stopidentisch true ist.

Hinweis

Das Signal zum Auslösen des Ereignisses wird immer für die Elapsed Ausführung in einem Thread in die ThreadPool Warteschlange gestellt. Dies kann dazu führen, dass das Elapsed Ereignis ausgelöst wird, nachdem die Enabled Eigenschaft auf .false Das Codebeispiel für die Stop Methode zeigt eine Möglichkeit, um diese Racebedingung zu umgehen.

Wenn Enabled dieses Ereignis auf "und auf" festgelegt truefalseAutoReset ist, löst das Timer Ereignis nur einmal ausElapsed, wenn das Intervall zum ersten Mal verstrichen ist.

Wenn das Intervall nach dem Timer Start festgelegt ist, wird die Anzahl zurückgesetzt. Wenn Sie z. B. das Intervall auf 5 Sekunden festlegen und dann die Enabled Eigenschaft auf " trueFestlegen" festlegen, beginnt die Anzahl zum Zeitpunkt Enabled des Festlegens. Wenn Sie das Intervall auf 10 Sekunden zurücksetzen, wenn die Anzahl 3 Sekunden beträgt, wird das Elapsed Ereignis zum ersten Mal 13 Sekunden nach Enabled dem Festlegen auf true".

Hinweis

Einige visuelle Designer, z. B. die in Microsoft Visual Studio, legen die Enabled Eigenschaft beim Einfügen einer neuen TimerEigenschaft festtrue.

Weitere Informationen

• Interval
• AutoReset
• Start()
• Stop()
• Elapsed