Поделиться через

Timer.Change Метод

Определение

Пространство имен:
System.Threading
Сборки:
mscorlib.dll, System.Threading.Timer.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Threading.Timer.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Меняет время запуска и интервал между вызовами метода таймера.

Перегрузки

Имя Описание
Change(Int32, Int32)

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные знаковые целые числа для измерения временных интервалов.
Change(Int64, Int64)

Меняет время запуска и интервал между вызовами метода таймера, используя 64-разрядные знаковые целые числа для измерения временных интервалов.
Change(TimeSpan, TimeSpan)

Меняет время запуска и интервал межу вызовами метода таймера, используя значения объекта TimeSpan для измерения временных интервалов.
Change(UInt32, UInt32)

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные целые числа без знака для измерения временных интервалов.

Change(Int32, Int32)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные знаковые целые числа для измерения временных интервалов.

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

Параметры

dueTime
Int32

Количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера. Задайте значение ноль (0) для немедленного перезапуска таймера.

period
Int32

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer. Следует задать поле Infinite для отключения периодической сигнализации.

Возвращаемое значение

Boolean

Значение true, если таймер успешно обновлен; в противном случае — значение false.

Исключения

ObjectDisposedException

Объект Timer уже был удален.

ArgumentOutOfRangeException

Значение параметра dueTime или period отрицательно, и не равно Infinite.

Примеры

В следующем примере кода показано, как запустить Timer и после заданного количества вызовов изменить его точку.

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.

Комментарии

Метод обратного вызова вызывается один раз после dueTime истечения и после этого каждый раз, когда интервал времени, указанный period в параметрах elapses.

Если dueTime равно нулю (0), метод обратного вызова вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, метод обратного вызова никогда не вызывается; таймер отключен, но его можно включить повторно, вызвав Change и указав положительное значение для dueTime.

Если period значение равно нулю (0) или Timeout.Infinite, а dueTime не Timeout.Infiniteравно , метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.

Метод Change можно вызвать из делегата TimerCallback .

См. также раздел

Применяется к

Change(Int64, Int64)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Меняет время запуска и интервал между вызовами метода таймера, используя 64-разрядные знаковые целые числа для измерения временных интервалов.

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

Параметры

dueTime
Int64

Количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера. Задайте значение ноль (0) для немедленного перезапуска таймера. Значение должно быть меньше или равно 4294967294.

period
Int64

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer. Следует задать поле Infinite для отключения периодической сигнализации.

Возвращаемое значение

Boolean

Значение true, если таймер успешно обновлен; в противном случае — значение false.

Исключения

ObjectDisposedException

Объект Timer уже был удален.

ArgumentOutOfRangeException

Значение dueTime или period меньше –1.

-или-

Значение dueTime или period больше чем 4294967294.

Комментарии

Метод обратного вызова вызывается один раз после dueTime истечения и после этого каждый раз, когда интервал времени, указанный period в параметрах elapses.

Если dueTime равно нулю (0), метод обратного вызова вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, метод обратного вызова никогда не вызывается; таймер отключен, но его можно включить повторно, вызвав Change и указав положительное значение для dueTime.

Если period значение равно нулю (0) или Timeout.Infinite, а dueTime не Timeout.Infiniteравно , метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.

Метод Change можно вызвать из делегата TimerCallback .

См. также раздел

Применяется к

Change(TimeSpan, TimeSpan)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Меняет время запуска и интервал межу вызовами метода таймера, используя значения объекта 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

Параметры

dueTime
TimeSpan

Объект TimeSpan, представляющий количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer. Следует задать поле InfiniteTimeSpan для того, чтобы не допустить повторный запуск таймера. Задайте значение Zero для немедленного перезапуска таймера.

period
TimeSpan

Временной интервал между вызовами метода обратного вызова, определенный в конструкторе объекта Timer. Следует задать поле InfiniteTimeSpan для отключения периодической сигнализации.

Возвращаемое значение

Boolean

Значение true, если таймер успешно обновлен; в противном случае — значение false.

Реализации

Change(TimeSpan, TimeSpan)

Исключения

ObjectDisposedException

Объект Timer уже был удален.

ArgumentOutOfRangeException

Значение параметра dueTime или period в миллисекундах меньше -1.

NotSupportedException

Значение параметра dueTime или period в миллисекундах больше 4294967294.

Примеры

В следующем примере кода показано, как запустить Timer и после заданного количества вызовов изменить его точку.

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

Комментарии

Метод обратного вызова вызывается один раз после dueTime истечения и после этого каждый раз, когда интервал времени, указанный period в параметрах elapses.

Если dueTime имеет значение TimeSpan.Zero, метод обратного вызова вызывается немедленно. Если dueTime имеет значение InfiniteTimeSpan, метод обратного вызова никогда не вызывается; таймер отключен, но его можно включить повторно, вызвав Change и указав положительное значение для dueTime.

Если period имеет значение TimeSpan.Zero или InfiniteTimeSpan, и dueTime является положительным, метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав значение больше нуля для period.

Метод Change можно вызвать из делегата TimerCallback .

См. также раздел

Применяется к

Change(UInt32, UInt32)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Внимание

Этот API несовместим с CLS.

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные целые числа без знака для измерения временных интервалов.

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

Параметры

dueTime
UInt32

Количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера. Задайте значение ноль (0) для немедленного перезапуска таймера.

period
UInt32

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer. Следует задать поле Infinite для отключения периодической сигнализации.

Возвращаемое значение

Boolean

Значение true, если таймер успешно обновлен; в противном случае — значение false.

Атрибуты
CLSCompliantAttribute

Исключения

ObjectDisposedException

Объект Timer уже был удален.

Комментарии

Метод обратного вызова вызывается один раз после dueTime истечения и после этого каждый раз, когда интервал времени, указанный period в параметрах elapses.

Если dueTime равно нулю (0), метод обратного вызова вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, метод обратного вызова никогда не вызывается; таймер отключен, но его можно включить повторно, вызвав Change и указав положительное значение для dueTime.

Если period значение равно нулю (0) или Timeout.Infinite, а dueTime не Timeout.Infiniteравно , метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.

Метод Change можно вызвать из делегата TimerCallback .

См. также раздел

Применяется к