Timer.Interval-Eigenschaft

Ruft das Intervall ab, in dem das Elapsed-Ereignis ausgelöst wird, oder legt dieses fest.

Namespace: System.Timers
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property Interval As Double
'Usage
Dim instance As Timer
Dim value As Double

value = instance.Interval

instance.Interval = value

public double Interval { get; set; }

public:
property double Interval {
    double get ();
    void set (double value);
}

/** @property */
public double get_Interval ()

/** @property */
public void set_Interval (double value)

public function get Interval () : double

public function set Interval (value : double)

Eigenschaftenwert

Die Zeit zwischen den Auslösezeitpunkten des Elapsed-Ereignisses in Millisekunden. Der Standardwert ist 100 Millisekunden.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Das Intervall ist kleiner oder gleich 0 (null).

Hinweise

Wenn das Intervall nach dem Start von Timer festgelegt wird, erfolgt ein Zurücksetzen des Zählers. Wenn Sie das Intervall z. B. auf 5 Sekunden festlegen und anschließend die Enabled-Eigenschaft auf true festlegen, beginnt der Zählvorgang zu dem Zeitpunkt, zu dem Enabled festgelegt wird. Wenn Sie das Intervall auf 10 Sekunden zurücksetzen, während der Zähler auf 3 Sekunden steht, wird das Elapsed-Ereignis das erste Mal 13 Sekunden nach dem Festlegen von Enabled auf true ausgelöst.

Wenn Enabled auf true und AutoReset auf false festgelegt ist, löst Timer das Elapsed-Ereignis nur einmal nach dem ersten Ablauf des Intervalls aus.

Beispiel

Im folgenden Beispiel wird ein Timer erstellt, der alle 5 Sekunden "Hello World!" in der Konsole anzeigt.

Verwenden Sie für dieses Beispiel den System.Timers-Namespace.

Imports System
Imports System.Timers

Public Class Timer1
    
    Public Shared Sub Main()
        ' Normally, the timer is declared at the class level, so
        ' that it doesn't go out of scope when the method ends.
        ' In this example, the timer is needed only while Main 
        ' is executing. However, KeepAlive must be used at the
        ' end of Main, to prevent the JIT compiler from allowing 
        ' aggressive garbage collection to occur before Main 
        ' ends.
        Dim aTimer As New System.Timers.Timer()

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

        ' Set the Interval to 2 seconds (2000 milliseconds).
        aTimer.Interval = 2000
        aTimer.Enabled = True
        
        Console.WriteLine("Press the Enter key to exit the program.")
        Console.ReadLine()

        ' Keep the timer alive until the end of Main.
        GC.KeepAlive(aTimer)
    End Sub
        
    ' Specify what you want to happen when the Elapsed event is 
    ' raised.
    Private Shared Sub OnTimedEvent(source As Object, e As ElapsedEventArgs)
        Console.WriteLine("Hello World!")
    End Sub
End Class

using System;
using System.Timers;

public class Timer1
{
    public static void Main()
    {
        // Normally, the timer is declared at the class level, so
        // that it doesn't go out of scope when the method ends.
        // In this example, the timer is needed only while Main 
        // is executing. However, KeepAlive must be used at the
        // end of Main, to prevent the JIT compiler from allowing 
        // aggressive garbage collection to occur before Main 
        // ends.
        System.Timers.Timer aTimer = new System.Timers.Timer();

        // Hook up the Elapsed event for the timer.
        aTimer.Elapsed += new ElapsedEventHandler(OnTimedEvent);

        // Set the Interval to 2 seconds (2000 milliseconds).
        aTimer.Interval = 2000;
        aTimer.Enabled = true;
 
        Console.WriteLine("Press the Enter key to exit the program.");
        Console.ReadLine();

        // Keep the timer alive until the end of Main.
        GC.KeepAlive(aTimer);
    }
 
    // Specify what you want to happen when the Elapsed event is 
    // raised.
    private static void OnTimedEvent(object source, ElapsedEventArgs e)
    {
        Console.WriteLine("Hello World!");
    }
}
 

#using <system.dll>

using namespace System;
using namespace System::Timers;

public ref class Timer1
{
public:
   static void Demo()
   {
      // Normally, the timer is declared at the class level, so
      // that it doesn't go out of scope when the method ends.
      // In this example, the timer is needed only while Demo
      // is executing. However, KeepAlive must be used at the
      // end of Demo, to prevent the JIT compiler from allowing 
      // aggressive garbage collection to occur before Demo
      // ends.
      System::Timers::Timer^ aTimer = gcnew System::Timers::Timer;

      // Hook up the Elapsed event for the timer.
      aTimer->Elapsed += gcnew ElapsedEventHandler( Timer1::OnTimedEvent );
      
      // Set the Interval to 2 seconds (2000 milliseconds).
      aTimer->Interval = 2000;
      aTimer->Enabled = true;

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

      // Keep the timer alive until the end of the Demo method.
      GC::KeepAlive(aTimer);
   }


private:
   // Specify what you want to happen when the Elapsed event is 
   // raised.
   static void OnTimedEvent( Object^ /*source*/, ElapsedEventArgs^ /*e*/ )
   {
      Console::WriteLine( "Hello World!" );
   }

};

int main()
{
   Timer1::Demo();
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Timer-Klasse
Timer-Member
System.Timers-Namespace
Timer.AutoReset-Eigenschaft
Timer.Enabled-Eigenschaft
Elapsed