Timer Costruttori

Definizione

Spazio dei nomi:: System.Threading

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll, System.Threading.Timer.dll

Assembly:: System.Threading.Timer.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe Timer.

Overload

Nome	Descrizione
Timer(TimerCallback)	Inizializza una nuova istanza della Timer classe con un periodo infinito e un tempo di scadenza infinito, utilizzando l'oggetto appena creato Timer come oggetto di stato.
Timer(TimerCallback, Object, Int32, Int32)	Inizializza una nuova istanza della `Timer` classe utilizzando un intero con segno a 32 bit per specificare l'intervallo di tempo.
Timer(TimerCallback, Object, Int64, Int64)	Inizializza una nuova istanza della `Timer` classe utilizzando interi con segno a 64 bit per misurare gli intervalli di tempo.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Inizializza una nuova istanza della `Timer` classe utilizzando TimeSpan i valori per misurare gli intervalli di tempo.
Timer(TimerCallback, Object, UInt32, UInt32)	Inizializza una nuova istanza della `Timer` classe utilizzando interi senza segno a 32 bit per misurare gli intervalli di tempo.

Timer(TimerCallback)

Inizializza una nuova istanza della Timer classe con un periodo infinito e un tempo di scadenza infinito, utilizzando l'oggetto appena creato Timer come oggetto di stato.

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)

Parametri

callback: TimerCallback

Delegato TimerCallback che rappresenta un metodo da eseguire.

Esempio

Nell'esempio di codice seguente viene creato un nuovo timer, usando il timer stesso come oggetto di stato. Il Change metodo viene utilizzato per avviare il timer. Quando si verifica il callback timer, l'oggetto di stato viene usato per disattivare il timer.

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

Commenti

Chiamare questo costruttore quando si desidera utilizzare l'oggetto Timer stesso come oggetto di stato. Dopo aver creato il timer, usare il Change metodo per impostare l'intervallo e il tempo di scadenza.

Questo costruttore specifica un tempo di scadenza infinito prima del primo callback e un intervallo infinito tra i callback, per impedire che il primo callback si verifichi prima che l'oggetto Timer venga assegnato all'oggetto di stato.

Il metodo specificato per callback deve essere reentrant, perché viene chiamato sui ThreadPool thread. Il metodo può essere eseguito simultaneamente su due thread del pool di thread se l'intervallo timer è inferiore al tempo necessario per eseguire il metodo oppure se tutti i thread del pool di thread sono in uso e il metodo viene accodato più volte.

Si applica a

Timer(TimerCallback, Object, Int32, Int32)

Inizializza una nuova istanza della Timer classe utilizzando un intero con segno a 32 bit per specificare l'intervallo di tempo.

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)

Parametri

callback: TimerCallback

Delegato TimerCallback che rappresenta un metodo da eseguire.

state: Object

Oggetto contenente informazioni da utilizzare dal metodo di callback o null.

dueTime: Int32

Quantità di tempo di ritardo prima callback che venga richiamata, in millisecondi. Specificare Infinite per impedire l'avvio del timer. Specificare zero (0) per avviare immediatamente il timer.

period: Int32

Intervallo di tempo tra le chiamate di callback, in millisecondi. Specificare Infinite per disabilitare la segnalazione periodica.

Eccezioni

ArgumentOutOfRangeException

Il dueTime parametro o period è negativo e non è uguale a Infinite.

ArgumentNullException

Il callback parametro è null.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un TimerCallback delegato e inizializzare una nuova istanza della Timer classe .

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.

Commenti

Il delegato specificato dal callback parametro viene richiamato una volta dopo dueTime la scadenza e successivamente ogni volta che scade l'intervallo period di tempo.

Se dueTime è zero (0), callback viene richiamato immediatamente. Se dueTime è Timeout.Infinite, callback non viene richiamato; il timer è disabilitato, ma può essere riabilitato chiamando il Change metodo .

Poiché la classe Timer ha la stessa risoluzione dell'orologio di sistema, ovvero circa 15 millisecondi nei sistemi Windows 7 e Windows 8, il delegato callback viene eseguito a intervalli definiti dalla risoluzione del clock di sistema se period è minore della risoluzione del clock di sistema. Se period è zero (0) o Timeout.Infinite non dueTimeTimeout.Infiniteè , callback viene richiamato una volta; il comportamento periodico del timer è disabilitato, ma può essere riabilitato usando il Change metodo .

Note

L'orologio di sistema usato è lo stesso orologio usato da GetTickCount, che non è interessato dalle modifiche apportate con timeBeginPeriod e timeEndPeriod.

Vedi anche

Timer

Si applica a

Timer(TimerCallback, Object, Int64, Int64)

Inizializza una nuova istanza della Timer classe utilizzando interi con segno a 64 bit per misurare gli intervalli di tempo.

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)

Parametri

callback: TimerCallback

Delegato TimerCallback che rappresenta un metodo da eseguire.

state: Object

Oggetto contenente informazioni da utilizzare dal metodo di callback o null.

dueTime: Int64

Quantità di tempo di ritardo prima callback che venga richiamata, in millisecondi. Specificare Infinite per impedire l'avvio del timer. Specificare zero (0) per avviare immediatamente il timer.

period: Int64

Intervallo di tempo tra le chiamate di callback, in millisecondi. Specificare Infinite per disabilitare la segnalazione periodica.

Eccezioni

ArgumentOutOfRangeException

Il dueTime parametro o period è negativo e non è uguale a Infinite.

NotSupportedException

Il dueTime parametro o period è maggiore di 4294967294.

Commenti

Il delegato specificato dal callback parametro viene richiamato una volta dopo dueTime la scadenza e successivamente ogni volta che scade l'intervallo period di tempo.

Se period è zero (0) o Timeout.Infinite non dueTimeTimeout.Infiniteè , callback viene richiamato una volta; il comportamento periodico del timer è disabilitato, ma può essere riabilitato usando il Change metodo .

Note

L'orologio di sistema usato è lo stesso orologio usato da GetTickCount, che non è interessato dalle modifiche apportate con timeBeginPeriod e timeEndPeriod.

Vedi anche

Timer

Si applica a

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Inizializza una nuova istanza della Timer classe utilizzando TimeSpan i valori per misurare gli intervalli di tempo.

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)

Parametri

callback: TimerCallback

Delegato che rappresenta un metodo da eseguire.

state: Object

Oggetto contenente informazioni da utilizzare dal metodo di callback o null.

dueTime: TimeSpan

Quantità di tempo da ritardare prima che venga richiamato .callback Specificare InfiniteTimeSpan per impedire l'avvio del timer. Specificare Zero per avviare immediatamente il timer.

period: TimeSpan

Intervallo di tempo tra le chiamate di callback. Specificare InfiniteTimeSpan per disabilitare la segnalazione periodica.

Eccezioni

ArgumentOutOfRangeException

Il numero di millisecondi nel valore di dueTime o period è negativo e non uguale a Infiniteo è maggiore di Int32.MaxValue.

ArgumentNullException

Il callback parametro è null.

Esempio

Nell'esempio di codice seguente viene illustrato come creare un TimerCallback delegato e inizializzare una nuova istanza della Timer classe .

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

Commenti

Il delegato specificato dal callback parametro viene richiamato una volta dopo dueTime la scadenza e successivamente ogni volta che scade l'intervallo period di tempo.

Se dueTime è zero (0), callback viene richiamato immediatamente. Se dueTime è negativo uno (-1) millisecondi, callback non viene richiamato; il timer è disabilitato, ma può essere riabilitato chiamando il Change metodo .

Poiché la classe Timer ha la stessa risoluzione dell'orologio di sistema, ovvero circa 15 millisecondi nei sistemi Windows 7 e Windows 8, il delegato callback viene eseguito a intervalli definiti dalla risoluzione del clock di sistema se period è minore della risoluzione del clock di sistema. Se period è zero (0) o negativo uno (-1) millisecondi ed dueTime è positivo, viene richiamato una volta; callback il comportamento periodico del timer è disabilitato, ma può essere riabilitato usando il Change metodo .

Note

L'orologio di sistema usato è lo stesso orologio usato da GetTickCount, che non è interessato dalle modifiche apportate con timeBeginPeriod e timeEndPeriod.

Vedi anche

Timer

Si applica a

Timer(TimerCallback, Object, UInt32, UInt32)

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della Timer classe utilizzando interi senza segno a 32 bit per misurare gli intervalli di tempo.

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)

Parametri

callback: TimerCallback

Delegato che rappresenta un metodo da eseguire.

state: Object

Oggetto contenente informazioni da utilizzare dal metodo di callback o null.

dueTime: UInt32

Quantità di tempo di ritardo prima callback che venga richiamata, in millisecondi. Specificare Infinite per impedire l'avvio del timer. Specificare zero (0) per avviare immediatamente il timer.

period: UInt32

Intervallo di tempo tra le chiamate di callback, in millisecondi. Specificare Infinite per disabilitare la segnalazione periodica.

Attributi: CLSCompliantAttribute

Eccezioni

ArgumentOutOfRangeException

Il dueTime parametro o period è negativo e non è uguale a Infinite.

ArgumentNullException

Il callback parametro è null.

Commenti

Il delegato specificato dal callback parametro viene richiamato una volta dopo dueTime la scadenza e successivamente ogni volta che scade l'intervallo period di tempo.

Note

L'orologio di sistema usato è lo stesso orologio usato da GetTickCount, che non è interessato dalle modifiche apportate con timeBeginPeriod e timeEndPeriod.

Vedi anche

Timer

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?