Timer Konstruktorer

Definition

Namnområde:: System.Threading

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Threading.Timer.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Sammansättningar:: mscorlib.dll, System.Threading.Timer.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av Timer klassen.

Överlagringar

Name	Description
Timer(TimerCallback)	Initierar en ny instans av Timer klassen med en oändlig period och en oändlig förfallotid med det nyligen skapade Timer objektet som tillståndsobjekt.
Timer(TimerCallback, Object, Int32, Int32)	Initierar en ny instans av `Timer` klassen med ett 32-bitars signerat heltal för att ange tidsintervallet.
Timer(TimerCallback, Object, Int64, Int64)	Initierar en ny instans av klassen med hjälp av `Timer` 64-bitars signerade heltal för att mäta tidsintervall.
Timer(TimerCallback, Object, TimeSpan, TimeSpan)	Initierar en ny instans av klassen med hjälp `Timer` av TimeSpan värden för att mäta tidsintervall.
Timer(TimerCallback, Object, UInt32, UInt32)	Initierar en ny instans av `Timer` klassen med 32-bitars osignerade heltal för att mäta tidsintervall.

Timer(TimerCallback)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Initierar en ny instans av Timer klassen med en oändlig period och en oändlig förfallotid med det nyligen skapade Timer objektet som tillståndsobjekt.

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)

Parametrar

callback: TimerCallback

Ett TimerCallback ombud som representerar en metod som ska köras.

Exempel

I följande kodexempel skapas en ny timer med själva timern som tillståndsobjekt. Metoden Change används för att starta timern. När timerns motringning inträffar används tillståndsobjektet för att inaktivera timern.

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

Kommentarer

Anropa den här konstruktorn när du vill använda Timer själva objektet som tillståndsobjekt. När du har skapat timern använder du Change metoden för att ange intervallet och förfallstiden.

Den här konstruktorn anger en oändlig förfallotid före det första återanropet och ett oändligt intervall mellan återanrop, för att förhindra att det första återanropet Timer inträffar innan objektet tilldelas tillståndsobjektet.

Metoden som anges för callback bör vara reentrant eftersom den anropas på ThreadPool trådar. Metoden kan köras samtidigt på två trådpoolstrådar om tidsintervallet är mindre än den tid som krävs för att köra metoden, eller om alla trådpooltrådar används och metoden placeras i kö flera gånger.

Gäller för

Timer(TimerCallback, Object, Int32, Int32)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Initierar en ny instans av Timer klassen med ett 32-bitars signerat heltal för att ange tidsintervallet.

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);

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)

Parametrar

callback: TimerCallback

Ett TimerCallback ombud som representerar en metod som ska köras.

state: Object

Ett objekt som innehåller information som ska användas av motringningsmetoden, eller null.

dueTime: Int32

Hur lång tid som ska fördröjas innan callback anropas i millisekunder. Ange Infinite för att förhindra att timern startar. Ange noll (0) för att starta timern omedelbart.

period: Int32

Tidsintervallet mellan anrop av callback, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Undantag

ArgumentOutOfRangeException

Parametern dueTime eller period är negativ och är inte lika med Infinite.

ArgumentNullException

Parametern callback är null.

Exempel

I följande kodexempel visas hur du skapar ett TimerCallback ombud och initierar en ny instans av Timer klassen.

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.

Kommentarer

Ombudet som anges av parametern callback anropas en gång efter dueTime förflutit och därefter varje gång period tidsintervallet förflutit.

Om dueTime är noll (0) callback anropas omedelbart. Om dueTime är Timeout.Infiniteanropas inte . callback Timern är inaktiverad, men kan återaktiveras genom att anropa Change metoden.

Eftersom klassen Timer har samma upplösning som systemklockan, vilket är cirka 15 millisekunder på Windows 7- och Windows 8 system, körs callback ombud med intervall som definieras av systemklockans upplösning om period är mindre än systemklockans upplösning. Om period är noll (0) eller Timeout.Infinite och dueTime inte Timeout.Infiniteär , callback anropas en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras med hjälp av Change metoden.

Note

Systemklockan som används är samma klocka som används av GetTickCount, som inte påverkas av ändringar som gjorts med timeBeginPeriod och timeEndPeriod.

Se även

timrar

Gäller för

Timer(TimerCallback, Object, Int64, Int64)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Initierar en ny instans av klassen med hjälp av Timer 64-bitars signerade heltal för att mäta tidsintervall.

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);

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)

Parametrar

callback: TimerCallback

Ett TimerCallback ombud som representerar en metod som ska köras.

state: Object

Ett objekt som innehåller information som ska användas av motringningsmetoden, eller null.

dueTime: Int64

Hur lång tid som ska fördröjas innan callback anropas i millisekunder. Ange Infinite för att förhindra att timern startar. Ange noll (0) för att starta timern omedelbart.

period: Int64

Tidsintervallet mellan anrop av callback, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Undantag

ArgumentOutOfRangeException

Parametern dueTime eller period är negativ och är inte lika med Infinite.

NotSupportedException

Parametern dueTime eller period är större än 4294967294.

Kommentarer

Ombudet som anges av parametern callback anropas en gång efter dueTime förflutit och därefter varje gång period tidsintervallet förflutit.

Om dueTime är noll (0) callback anropas omedelbart. Om dueTime är Timeout.Infiniteanropas inte . callback Timern är inaktiverad, men kan återaktiveras genom att anropa Change metoden.

Om period är noll (0) eller Timeout.Infinite och dueTime inte Timeout.Infiniteär , callback anropas en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras med hjälp av Change metoden.

Note

Systemklockan som används är samma klocka som används av GetTickCount, som inte påverkas av ändringar som gjorts med timeBeginPeriod och timeEndPeriod.

Se även

timrar

Gäller för

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Initierar en ny instans av klassen med hjälp Timer av TimeSpan värden för att mäta tidsintervall.

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);

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)

Parametrar

callback: TimerCallback

Ett ombud som representerar en metod som ska köras.

state: Object

Ett objekt som innehåller information som ska användas av motringningsmetoden, eller null.

dueTime: TimeSpan

Hur lång tid det ska ta innan callback anropas. Ange InfiniteTimeSpan för att förhindra att timern startar. Ange Zero att timern ska startas omedelbart.

period: TimeSpan

Tidsintervallet mellan anrop av callback. Ange InfiniteTimeSpan för att inaktivera periodisk signalering.

Undantag

ArgumentOutOfRangeException

Antalet millisekunder i värdet dueTime för eller period är negativt och inte lika med Infinite, eller är större än Int32.MaxValue.

ArgumentNullException

Parametern callback är null.

Exempel

I följande kodexempel visas hur du skapar ett TimerCallback ombud och initierar en ny instans av Timer klassen.

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

Kommentarer

Ombudet som anges av parametern callback anropas en gång efter dueTime förflutit och därefter varje gång period tidsintervallet förflutit.

Om dueTime är noll (0) callback anropas omedelbart. Om dueTime är negativ (-1) millisekunder anropas callback inte; timern är inaktiverad, men kan återaktiveras genom att anropa Change metoden.

Eftersom klassen Timer har samma upplösning som systemklockan, vilket är cirka 15 millisekunder på Windows 7- och Windows 8 system, körs callback ombud med intervall som definieras av systemklockans upplösning om period är mindre än systemklockans upplösning. Om period är noll (0) eller negativt en (-1) millisekunder och dueTime är positiv anropas callback en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras med hjälp av Change metoden.

Note

Systemklockan som används är samma klocka som används av GetTickCount, som inte påverkas av ändringar som gjorts med timeBeginPeriod och timeEndPeriod.

Se även

timrar

Gäller för

Timer(TimerCallback, Object, UInt32, UInt32)

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Källa:: Timer.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av Timer klassen med 32-bitars osignerade heltal för att mäta tidsintervall.

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)]
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)

Parametrar

callback: TimerCallback

Ett ombud som representerar en metod som ska köras.

state: Object

Ett objekt som innehåller information som ska användas av motringningsmetoden, eller null.

dueTime: UInt32

Hur lång tid som ska fördröjas innan callback anropas i millisekunder. Ange Infinite för att förhindra att timern startar. Ange noll (0) för att starta timern omedelbart.

period: UInt32

Tidsintervallet mellan anrop av callback, i millisekunder. Ange Infinite för att inaktivera periodisk signalering.

Attribut: CLSCompliantAttribute

Undantag

ArgumentOutOfRangeException

Parametern dueTime eller period är negativ och är inte lika med Infinite.

ArgumentNullException

Parametern callback är null.

Kommentarer

Ombudet som anges av parametern callback anropas en gång efter dueTime förflutit och därefter varje gång period tidsintervallet förflutit.

Om dueTime är noll (0) callback anropas omedelbart. Om dueTime är Timeout.Infiniteanropas inte . callback Timern är inaktiverad, men kan återaktiveras genom att anropa Change metoden.

Note

Systemklockan som används är samma klocka som används av GetTickCount, som inte påverkas av ändringar som gjorts med timeBeginPeriod och timeEndPeriod.

Se även

timrar

Gäller för

Feedback

Var den här sidan till hjälp?