Partager via

Timer.Change Méthode

Définition

Espace de noms:
System.Threading
Assemblys:
mscorlib.dll, System.Threading.Timer.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Threading.Timer.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie.

Surcharges

Nom Description
Change(Int32, Int32)

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 32 bits signés.
Change(Int64, Int64)

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 64 bits signés.
Change(TimeSpan, TimeSpan)

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide de valeurs TimeSpan.
Change(UInt32, UInt32)

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 32 bits non signés.

Change(Int32, Int32)

Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 32 bits signés.

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

Paramètres

dueTime
Int32

Délai d'attente, en millisecondes, avant l'appel de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour empêcher le redémarrage de la minuterie. Spécifiez zéro (0) pour redémarrer la minuterie immédiatement.

period
Int32

Intervalle de temps, en millisecondes, entre les appels de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour désactiver la signalisation périodique.

Retours

Boolean

true si le minuteur a été correctement mis à jour ; sinon, false.

Exceptions

ObjectDisposedException

Timer a déjà été supprimé.

ArgumentOutOfRangeException

Le paramètre dueTime ou period est négatif et différent de Infinite.

Exemples

L’exemple de code suivant montre comment démarrer un Timer et, après un nombre défini d’appels, modifier sa période.

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.

Remarques

La méthode de rappel est appelée une fois après dueTime l’expiration, puis chaque fois que l’intervalle de temps spécifié par period expire.

Si dueTime est zéro (0), la méthode de rappel est appelée immédiatement. Si dueTime a la valeur Timeout.Infinite, la méthode de rappel n’est jamais appelée ; le minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour dueTime.

Si period est zéro (0) ou Timeout.Infinite, et dueTime n’est pas Timeout.Infinite, la méthode de rappel est appelée une seule fois ; le comportement périodique du minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour period.

La Change méthode peut être appelée à partir du TimerCallback délégué.

Voir aussi

S’applique à

Change(Int64, Int64)

Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 64 bits signés.

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

Paramètres

dueTime
Int64

Délai d'attente, en millisecondes, avant l'appel de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour empêcher le redémarrage de la minuterie. Spécifiez zéro (0) pour redémarrer la minuterie immédiatement. Cette valeur doit être inférieure ou égale à 4294967294.

period
Int64

Intervalle de temps, en millisecondes, entre les appels de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour désactiver la signalisation périodique.

Retours

Boolean

true si le minuteur a été correctement mis à jour ; sinon, false.

Exceptions

ObjectDisposedException

Timer a déjà été supprimé.

ArgumentOutOfRangeException

dueTime ou period est inférieur à -1.

- ou -

dueTime ou period est supérieure à 4294967294.

Remarques

La méthode de rappel est appelée une fois après dueTime l’expiration, puis chaque fois que l’intervalle de temps spécifié par period expire.

Si dueTime est zéro (0), la méthode de rappel est appelée immédiatement. Si dueTime a la valeur Timeout.Infinite, la méthode de rappel n’est jamais appelée ; le minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour dueTime.

Si period est zéro (0) ou Timeout.Infinite, et dueTime n’est pas Timeout.Infinite, la méthode de rappel est appelée une seule fois ; le comportement périodique du minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour period.

La Change méthode peut être appelée à partir du TimerCallback délégué.

Voir aussi

S’applique à

Change(TimeSpan, TimeSpan)

Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide de valeurs TimeSpan.

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

Paramètres

dueTime
TimeSpan

TimeSpan représentant le délai d'attente avant l'appel de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez InfiniteTimeSpan pour empêcher le redémarrage de la minuterie. Spécifiez Zero pour redémarrer immédiatement le minuteur.

period
TimeSpan

Intervalle de temps entre les appels de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez InfiniteTimeSpan pour désactiver la signalisation périodique.

Retours

Boolean

true si le minuteur a été correctement mis à jour ; sinon, false.

Implémente

Change(TimeSpan, TimeSpan)

Exceptions

ObjectDisposedException

Timer a déjà été supprimé.

ArgumentOutOfRangeException

Le paramètre dueTime ou period, exprimé en millisecondes, est inférieur à -1.

NotSupportedException

Le paramètre dueTime ou period, exprimé en millisecondes, est supérieur à 4294967294.

Exemples

L’exemple de code suivant montre comment démarrer un Timer et, après un nombre défini d’appels, modifier sa période.

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

Remarques

La méthode de rappel est appelée une fois après dueTime l’expiration, puis chaque fois que l’intervalle de temps spécifié par period expire.

Si dueTime a la valeur TimeSpan.Zero, la méthode de rappel est appelée immédiatement. Si dueTime a la valeur InfiniteTimeSpan, la méthode de rappel n’est jamais appelée ; le minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour dueTime.

Si period est TimeSpan.Zero ou InfiniteTimeSpan, et dueTime est positif, la méthode de rappel est appelée une fois ; le comportement périodique du minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur supérieure à zéro pour period.

La Change méthode peut être appelée à partir du TimerCallback délégué.

Voir aussi

S’applique à

Change(UInt32, UInt32)

Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs
Source:
Timer.cs

Important

Cette API n’est pas conforme CLS.

Modifie l'heure de début et l'intervalle entre les appels de méthode d'une minuterie ; les intervalles de temps sont mesurés à l'aide d'entiers 32 bits non signés.

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

Paramètres

dueTime
UInt32

Délai d'attente, en millisecondes, avant l'appel de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour empêcher le redémarrage de la minuterie. Spécifiez zéro (0) pour redémarrer la minuterie immédiatement.

period
UInt32

Intervalle de temps, en millisecondes, entre les appels de la méthode de rappel spécifiée au moment de la construction de Timer. Spécifiez Infinite pour désactiver la signalisation périodique.

Retours

Boolean

true si le minuteur a été correctement mis à jour ; sinon, false.

Attributs
CLSCompliantAttribute

Exceptions

ObjectDisposedException

Timer a déjà été supprimé.

Remarques

La méthode de rappel est appelée une fois après dueTime l’expiration, puis chaque fois que l’intervalle de temps spécifié par period expire.

Si dueTime est zéro (0), la méthode de rappel est appelée immédiatement. Si dueTime a la valeur Timeout.Infinite, la méthode de rappel n’est jamais appelée ; le minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour dueTime.

Si period est zéro (0) ou Timeout.Infinite, et dueTime n’est pas Timeout.Infinite, la méthode de rappel est appelée une seule fois ; le comportement périodique du minuteur est désactivé, mais peut être réactivé en appelant Change et en spécifiant une valeur positive pour period.

La Change méthode peut être appelée à partir du TimerCallback délégué.

Voir aussi

S’applique à