Timer Konstruktory

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Runtime.dll

Inicializuje novou instanci Timer třídy.

Přetížení

Name	Description
Timer(TimerCallback)	Inicializuje novou instanci Timer třídy s nekonečným obdobím a nekonečným časem splnění pomocí nově vytvořeného Timer objektu jako stav objektu.
Timer(TimerCallback, Object, Int32, Int32)	Inicializuje novou instanci Timer třídy pomocí 32bitového signed integer k určení časového intervalu.
Timer(TimerCallback, Object, Int64, Int64)	Inicializuje novou instanci Timer třídy pomocí 64bitových signed integers k měření časových intervalů.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Inicializuje novou instanci Timer třídy pomocí TimeSpan hodnot k měření časových intervalů.
Timer(TimerCallback, Object, UInt32, UInt32)	Inicializuje novou instanci Timer třídy pomocí 32bitové celé číslo bez znaménka k měření časových intervalů.

Timer(TimerCallback)

Zdroj:

Timer.cs

Inicializuje novou instanci Timer třídy s nekonečným obdobím a nekonečným časem splnění pomocí nově vytvořeného Timer objektu jako stav objektu.

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)

Parametry

callback

TimerCallback

Delegát TimerCallback představující metodu, která se má spustit.

Příklady

Následující příklad kódu vytvoří nový časovač, pomocí časovače samotného jako stav objektu. Metoda Change se používá ke spuštění časovače. Když dojde k zpětnému volání časovače, objekt stavu se použije k vypnutí časovače.

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

Poznámky

Tento konstruktor zavolejte, pokud chcete použít Timer samotný objekt jako objekt stavu. Po vytvoření časovače použijte metodu Change k nastavení intervalu a času splnění.

Tento konstruktor určuje nekonečný čas splnění před prvním zpětným voláním a nekonečný interval mezi zpětnými voláními, aby se zabránilo výskytu prvního zpětného volání před Timer objektem stavu.

Metoda zadaná pro callback by měla být znovu zadána, protože je volána ve ThreadPool vláknech. Metodu lze provést současně na dvou vláknech fondu vláken, pokud je interval časovače kratší než doba potřebná ke spuštění metody, nebo pokud jsou všechna vlákna fondu vláken používána a metoda je zařazena do fronty vícekrát.

Timer(TimerCallback, Object, Int32, Int32)

Zdroj:

Timer.cs

Inicializuje novou instanci Timer třídy pomocí 32bitového signed integer k určení časového intervalu.

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)

Parametry

callback

TimerCallback

Delegát TimerCallback představující metodu, která se má spustit.

state

Object

Objekt obsahující informace, které mají být použity metodou zpětného volání, nebo null.

dueTime

Int32

Doba zpoždění před callback vyvolání v milisekundách. Zadejte Infinite , aby se časovač nespouští. Zadejte nulu (0), aby se časovač spustil okamžitě.

period

Int32

Časový interval mezi vyvoláním v callbackmilisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Výjimky

ArgumentOutOfRangeException

Nebo dueTimeperiod parametr je záporný a není roven Infinite.

ArgumentNullException

Parametr callback je null.

Příklady

Následující příklad kódu ukazuje, jak vytvořit TimerCallback delegáta a inicializovat novou instanci Timer třídy.

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.

Poznámky

Delegát určený parametrem callback se vyvolá jednou po dueTime uplynutí a po každém uplynutí časového intervalu period .

Pokud dueTime je nula (0), callback je vyvolána okamžitě. Pokud dueTime je Timeout.Infinite, callback není vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change metody.

Protože třída Timer má stejné rozlišení jako systémové hodiny, což je přibližně 15 milisekund v systémech Windows 7 a Windows 8, callback delegát provádí v intervalech definovaných rozlišení systémových hodin, pokud period je menší než rozlišení systémových hodin. Pokud period je nula (0) nebo Timeout.Infinite a dueTime není Timeout.Infinite, callback je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit pomocí Change metody.

Note

Systémové hodiny, které se používají, jsou stejné hodiny, které používá GetTickCount, což nejsou ovlivněny změnami provedenými v timeBeginPeriod a timeEndPeriod.

Metoda zadaná pro callback by měla být znovu zadána, protože je volána ve ThreadPool vláknech. Metodu lze provést současně na dvou vláknech fondu vláken, pokud je interval časovače kratší než doba potřebná ke spuštění metody, nebo pokud jsou všechna vlákna fondu vláken používána a metoda je zařazena do fronty vícekrát.

Viz také

• Časovače

Timer(TimerCallback, Object, Int64, Int64)

Zdroj:

Timer.cs

Inicializuje novou instanci Timer třídy pomocí 64bitových signed integers k měření časových intervalů.

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)

Parametry

callback

TimerCallback

Delegát TimerCallback představující metodu, která se má spustit.

state

Object

Objekt obsahující informace, které mají být použity metodou zpětného volání, nebo null.

dueTime

Int64

Doba zpoždění před callback vyvolání v milisekundách. Zadejte Infinite , aby se časovač nespouští. Zadejte nulu (0), aby se časovač spustil okamžitě.

period

Int64

Časový interval mezi vyvoláním v callbackmilisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Výjimky

ArgumentOutOfRangeException

Nebo dueTimeperiod parametr je záporný a není roven Infinite.

NotSupportedException

Parametr dueTime je period větší než 4294967294.

Poznámky

Delegát určený parametrem callback se vyvolá jednou po dueTime uplynutí a po každém uplynutí časového intervalu period .

Pokud dueTime je nula (0), callback je vyvolána okamžitě. Pokud dueTime je Timeout.Infinite, callback není vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change metody.

Protože třída Timer má stejné rozlišení jako systémové hodiny, což je přibližně 15 milisekund v systémech Windows 7 a Windows 8, callback delegát provádí v intervalech definovaných rozlišení systémových hodin, pokud period je menší než rozlišení systémových hodin.

Pokud period je nula (0) nebo Timeout.Infinite a dueTime není Timeout.Infinite, callback je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit pomocí Change metody.

Note

Systémové hodiny, které se používají, jsou stejné hodiny, které používá GetTickCount, což nejsou ovlivněny změnami provedenými v timeBeginPeriod a timeEndPeriod.

Metoda zadaná pro callback by měla být znovu zadána, protože je volána ve ThreadPool vláknech. Metodu lze provést současně na dvou vláknech fondu vláken, pokud je interval časovače kratší než doba potřebná ke spuštění metody, nebo pokud jsou všechna vlákna fondu vláken používána a metoda je zařazena do fronty vícekrát.

Viz také

• Časovače

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Zdroj:

Timer.cs

Inicializuje novou instanci Timer třídy pomocí TimeSpan hodnot k měření časových intervalů.

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)

Parametry

callback

TimerCallback

Delegát představující metodu, která se má spustit.

state

Object

Objekt obsahující informace, které mají být použity metodou zpětného volání, nebo null.

dueTime

TimeSpan

Doba, po kterou se má zpoždění před vyvoláním callback . Zadejte InfiniteTimeSpan , aby se časovač nespouští. Zadejte Zero , aby se časovač spustil okamžitě.

period

TimeSpan

Časový interval mezi vyvoláním funkce callback. Určete InfiniteTimeSpan , že chcete zakázat pravidelné signály.

Výjimky

ArgumentOutOfRangeException

Počet milisekund v hodnotě dueTime nebo period je záporný a nerovná se Infinitenebo je větší než Int32.MaxValue.

ArgumentNullException

Parametr callback je null.

Příklady

Následující příklad kódu ukazuje, jak vytvořit TimerCallback delegáta a inicializovat novou instanci Timer třídy.

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

Poznámky

Delegát určený parametrem callback se vyvolá jednou po dueTime uplynutí a po každém uplynutí časového intervalu period .

Pokud dueTime je nula (0), callback je vyvolána okamžitě. Pokud dueTime je záporná jedna (-1) milisekund, není vyvolána; callback časovač je zakázán, ale lze jej znovu povolit voláním Change metody.

Protože třída Timer má stejné rozlišení jako systémové hodiny, což je přibližně 15 milisekund v systémech Windows 7 a Windows 8, callback delegát provádí v intervalech definovaných rozlišení systémových hodin, pokud period je menší než rozlišení systémových hodin. Pokud period je nula (0) nebo záporná (-1) milisekund a dueTime je kladná, vyvolá se jednou; callback pravidelné chování časovače je zakázané, ale můžete ho Change znovu povolit pomocí metody.

Note

Systémové hodiny, které se používají, jsou stejné hodiny, které používá GetTickCount, což nejsou ovlivněny změnami provedenými v timeBeginPeriod a timeEndPeriod.

Metoda zadaná pro callback by měla být znovu zadána, protože je volána ve ThreadPool vláknech. Metodu lze provést současně na dvou vláknech fondu vláken, pokud je interval časovače kratší než doba potřebná ke spuštění metody, nebo pokud jsou všechna vlákna fondu vláken používána a metoda je zařazena do fronty vícekrát.

Viz také

• Časovače

Timer(TimerCallback, Object, UInt32, UInt32)

Zdroj:

Timer.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci Timer třídy pomocí 32bitové celé číslo bez znaménka k měření časových intervalů.

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)

Parametry

callback

TimerCallback

Delegát představující metodu, která se má spustit.

state

Object

Objekt obsahující informace, které mají být použity metodou zpětného volání, nebo null.

dueTime

UInt32

Doba zpoždění před callback vyvolání v milisekundách. Zadejte Infinite , aby se časovač nespouští. Zadejte nulu (0), aby se časovač spustil okamžitě.

period

UInt32

Časový interval mezi vyvoláním v callbackmilisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Nebo dueTimeperiod parametr je záporný a není roven Infinite.

ArgumentNullException

Parametr callback je null.

Poznámky

Delegát určený parametrem callback se vyvolá jednou po dueTime uplynutí a po každém uplynutí časového intervalu period .

Pokud dueTime je nula (0), callback je vyvolána okamžitě. Pokud dueTime je Timeout.Infinite, callback není vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change metody.

Protože třída Timer má stejné rozlišení jako systémové hodiny, což je přibližně 15 milisekund v systémech Windows 7 a Windows 8, callback delegát provádí v intervalech definovaných rozlišení systémových hodin, pokud period je menší než rozlišení systémových hodin. Pokud period je nula (0) nebo Timeout.Infinite a dueTime není Timeout.Infinite, callback je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit pomocí Change metody.

Note

Systémové hodiny, které se používají, jsou stejné hodiny, které používá GetTickCount, což nejsou ovlivněny změnami provedenými v timeBeginPeriod a timeEndPeriod.

Metoda zadaná pro callback by měla být znovu zadána, protože je volána ve ThreadPool vláknech. Metodu lze provést současně na dvou vláknech fondu vláken, pokud je interval časovače kratší než doba potřebná ke spuštění metody, nebo pokud jsou všechna vlákna fondu vláken používána a metoda je zařazena do fronty vícekrát.

Viz také

• Časovače