Timer.Change Methode

Definition

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer.

Überlädt

Name Beschreibung
Change(Int32, Int32)

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 32-Bit-ganzzahlige Ganzzahlen verwendet werden, um Zeitintervalle zu messen.

Change(Int64, Int64)

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 64-Bit-ganzzahlige Ganzzahlen verwendet werden, um Zeitintervalle zu messen.

Change(TimeSpan, TimeSpan)

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer mithilfe von TimeSpan Werten zum Messen von Zeitintervallen.

Change(UInt32, UInt32)

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 32-Bit-ganzzahlen ohne Vorzeichen verwendet werden, um Zeitintervalle zu messen.

Change(Int32, Int32)

Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 32-Bit-ganzzahlige Ganzzahlen verwendet werden, um Zeitintervalle zu messen.

public:
 bool Change(int dueTime, int period);
public bool Change(int dueTime, int period);
member this.Change : int * int -> bool
Public Function Change (dueTime As Integer, period As Integer) As Boolean

Parameter

dueTime
Int32

Die Zeitspanne, die vor dem Aufrufen der Rückrufmethode verzögert werden muss, die beim Timer Erstellen der Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um zu verhindern, dass der Timer neu gestartet wird. Geben Sie null (0) an, um den Timer sofort neu zu starten.

period
Int32

Das Zeitintervall zwischen Aufrufen der Rückrufmethode, die beim Erstellen der Timer Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um die regelmäßige Signalisierung zu deaktivieren.

Gibt zurück

truewenn der Timer erfolgreich aktualisiert wurde; andernfalls . false

Ausnahmen

Die Timer wurde bereits verworfen.

Der dueTime Parameter period ist negativ und ist nicht gleich Infinite.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Ein Timer - und nach einer festgelegten Anzahl von Aufrufen der zugehörigen Periode gestartet wird.

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.

Hinweise

Die Rückrufmethode wird einmal nach dueTime Ablauf aufgerufen, und danach jedes Mal, wenn das durch period Verstrichen angegebene Zeitintervall erfolgt.

Wenn dueTime null (0) ist, wird die Rückrufmethode sofort aufgerufen. Wenn dueTime ja Timeout.Infinite, wird die Rückrufmethode nie aufgerufen; der Timer ist deaktiviert, kann aber durch Aufrufen Change und Angeben eines positiven Werts erneut dueTimeaktiviert werden.

Wenn period null (0) oder Timeout.Infinite, andernfalls dueTimeTimeout.Infinite, wird die Rückrufmethode einmal aufgerufen. Das regelmäßige Verhalten des Timers ist deaktiviert, kann jedoch erneut aktiviert werden, indem Change ein positiver Wert aufgerufen und ein positiver Wert angegeben periodwird.

Die Change Methode kann von der TimerCallback Stellvertretung aufgerufen werden.

Weitere Informationen

Gilt für:

Change(Int64, Int64)

Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 64-Bit-ganzzahlige Ganzzahlen verwendet werden, um Zeitintervalle zu messen.

public:
 bool Change(long dueTime, long period);
public bool Change(long dueTime, long period);
member this.Change : int64 * int64 -> bool
Public Function Change (dueTime As Long, period As Long) As Boolean

Parameter

dueTime
Int64

Die Zeitspanne, die vor dem Aufrufen der Rückrufmethode verzögert werden muss, die beim Timer Erstellen der Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um zu verhindern, dass der Timer neu gestartet wird. Geben Sie null (0) an, um den Timer sofort neu zu starten. Dieser Wert muss kleiner oder gleich 4294967294 sein.

period
Int64

Das Zeitintervall zwischen Aufrufen der Rückrufmethode, die beim Erstellen der Timer Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um die regelmäßige Signalisierung zu deaktivieren.

Gibt zurück

truewenn der Timer erfolgreich aktualisiert wurde; andernfalls . false

Ausnahmen

Die Timer wurde bereits verworfen.

dueTime oder period kleiner als -1.

-oder-

dueTime oder period größer als 4294967294 ist.

Hinweise

Die Rückrufmethode wird einmal nach dueTime Ablauf aufgerufen, und danach jedes Mal, wenn das durch period Verstrichen angegebene Zeitintervall erfolgt.

Wenn dueTime null (0) ist, wird die Rückrufmethode sofort aufgerufen. Wenn dueTime ja Timeout.Infinite, wird die Rückrufmethode nie aufgerufen; der Timer ist deaktiviert, kann aber durch Aufrufen Change und Angeben eines positiven Werts erneut dueTimeaktiviert werden.

Wenn period null (0) oder Timeout.Infinite, andernfalls dueTimeTimeout.Infinite, wird die Rückrufmethode einmal aufgerufen. Das regelmäßige Verhalten des Timers ist deaktiviert, kann jedoch erneut aktiviert werden, indem Change ein positiver Wert aufgerufen und ein positiver Wert angegeben periodwird.

Die Change Methode kann von der TimerCallback Stellvertretung aufgerufen werden.

Weitere Informationen

Gilt für:

Change(TimeSpan, TimeSpan)

Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer mithilfe von TimeSpan Werten zum Messen von Zeitintervallen.

public:
 bool Change(TimeSpan dueTime, TimeSpan period);
public:
 virtual bool Change(TimeSpan dueTime, TimeSpan period);
public bool Change(TimeSpan dueTime, TimeSpan period);
member this.Change : TimeSpan * TimeSpan -> bool
abstract member Change : TimeSpan * TimeSpan -> bool
override this.Change : TimeSpan * TimeSpan -> bool
Public Function Change (dueTime As TimeSpan, period As TimeSpan) As Boolean

Parameter

dueTime
TimeSpan

A TimeSpan representing the time to delay before invoking the callback method specified when the Timer was build. Geben Sie an InfiniteTimeSpan , um zu verhindern, dass der Timer neu gestartet wird. Geben Sie Zero an, dass der Timer sofort neu gestartet werden soll.

period
TimeSpan

Das Zeitintervall zwischen Aufrufen der Rückrufmethode, die beim Erstellen der Timer Methode angegeben wurde. Geben Sie an InfiniteTimeSpan , um die regelmäßige Signalisierung zu deaktivieren.

Gibt zurück

truewenn der Timer erfolgreich aktualisiert wurde; andernfalls . false

Implementiert

Ausnahmen

Die Timer wurde bereits verworfen.

Der dueTime Parameter period in Millisekunden ist kleiner als -1.

Der dueTime Parameter period in Millisekunden ist größer als 4294967294.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Ein Timer - und nach einer festgelegten Anzahl von Aufrufen der zugehörigen Periode gestartet wird.

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

Hinweise

Die Rückrufmethode wird einmal nach dueTime Ablauf aufgerufen, und danach jedes Mal, wenn das durch period Verstrichen angegebene Zeitintervall erfolgt.

Ist dueTime dies TimeSpan.Zeroder Grund, wird die Rückrufmethode sofort aufgerufen. Wenn dueTime ja InfiniteTimeSpan, wird die Rückrufmethode nie aufgerufen; der Timer ist deaktiviert, kann aber durch Aufrufen Change und Angeben eines positiven Werts erneut dueTimeaktiviert werden.

Wenn period oder TimeSpan.ZeroInfiniteTimeSpan, und dueTime ist positiv, wird die Rückrufmethode einmal aufgerufen. Das regelmäßige Verhalten des Timers ist deaktiviert, kann jedoch erneut aktiviert werden, indem Change ein Wert aufgerufen und angegeben wird, der größer als Null periodist.

Die Change Methode kann von der TimerCallback Stellvertretung aufgerufen werden.

Weitere Informationen

Gilt für:

Change(UInt32, UInt32)

Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs
Quelle:
Timer.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Ändert die Startzeit und das Intervall zwischen Methodenaufrufen für einen Timer, wobei 32-Bit-ganzzahlen ohne Vorzeichen verwendet werden, um Zeitintervalle zu messen.

public:
 bool Change(System::UInt32 dueTime, System::UInt32 period);
[System.CLSCompliant(false)]
public bool Change(uint dueTime, uint period);
[<System.CLSCompliant(false)>]
member this.Change : uint32 * uint32 -> bool
Public Function Change (dueTime As UInteger, period As UInteger) As Boolean

Parameter

dueTime
UInt32

Die Zeitspanne, die vor dem Aufrufen der Rückrufmethode verzögert werden muss, die beim Timer Erstellen der Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um zu verhindern, dass der Timer neu gestartet wird. Geben Sie null (0) an, um den Timer sofort neu zu starten.

period
UInt32

Das Zeitintervall zwischen Aufrufen der Rückrufmethode, die beim Erstellen der Timer Rückrufmethode in Millisekunden angegeben wurde. Geben Sie an Infinite , um die regelmäßige Signalisierung zu deaktivieren.

Gibt zurück

truewenn der Timer erfolgreich aktualisiert wurde; andernfalls . false

Attribute

Ausnahmen

Die Timer wurde bereits verworfen.

Hinweise

Die Rückrufmethode wird einmal nach dueTime Ablauf aufgerufen, und danach jedes Mal, wenn das durch period Verstrichen angegebene Zeitintervall erfolgt.

Wenn dueTime null (0) ist, wird die Rückrufmethode sofort aufgerufen. Wenn dueTime ja Timeout.Infinite, wird die Rückrufmethode nie aufgerufen; der Timer ist deaktiviert, kann aber durch Aufrufen Change und Angeben eines positiven Werts erneut dueTimeaktiviert werden.

Wenn period null (0) oder Timeout.Infinite, andernfalls dueTimeTimeout.Infinite, wird die Rückrufmethode einmal aufgerufen. Das regelmäßige Verhalten des Timers ist deaktiviert, kann jedoch erneut aktiviert werden, indem Change ein positiver Wert aufgerufen und ein positiver Wert angegeben periodwird.

Die Change Methode kann von der TimerCallback Stellvertretung aufgerufen werden.

Weitere Informationen

Gilt für: