Timer.Change Метод

Определение

Меняет время запуска и интервал между вызовами метода таймера.Changes the start time and the interval between method invocations for a timer.

Перегрузки

Change(Int32, Int32)

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные знаковые целые числа для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 32-bit signed integers to measure time intervals.

Change(Int64, Int64)

Меняет время запуска и интервал между вызовами метода таймера, используя 64-разрядные знаковые целые числа для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 64-bit signed integers to measure time intervals.

Change(TimeSpan, TimeSpan)

Меняет время запуска и интервал межу вызовами метода таймера, используя значения объекта TimeSpan для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using TimeSpan values to measure time intervals.

Change(UInt32, UInt32)

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные целые числа без знака для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 32-bit unsigned integers to measure time intervals.

Change(Int32, Int32)

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные знаковые целые числа для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 32-bit signed integers to measure time intervals.

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.The amount of time to delay before the invoking the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера.Specify Infinite to prevent the timer from restarting. Задайте значение ноль (0) для немедленного перезапуска таймера.Specify zero (0) to restart the timer immediately.

period
Int32

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer.The time interval between invocations of the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для отключения периодической сигнализации.Specify Infinite to disable periodic signaling.

Возвраты

Значение true, если таймер успешно обновлен; в противном случае — значение false.true if the timer was successfully updated; otherwise, false.

Исключения

Объект Timer уже был удален.The Timer has already been disposed.

Значение параметра dueTime или period отрицательно, и не равно Infinite.The dueTime or period parameter is negative and is not equal to Infinite.

Примеры

В следующем примере кода показано, как запустить Timer и после заданного числа вызовов изменить его период.The following code example demonstrates how to start a Timer and, after a set number of invocations, change its period.

using namespace System;
using namespace System::Threading;

ref class StatusChecker
{
private:
    int invokeCount, maxCount;

public:
    StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    void CheckStatus(Object^ stateInfo)
    {
        AutoResetEvent^ autoEvent = dynamic_cast<AutoResetEvent^>(stateInfo);
        Console::WriteLine("{0:h:mm:ss.fff} Checking status {1,2}.",
                           DateTime::Now, ++invokeCount);

        if (invokeCount == maxCount) {
            // Reset the counter and signal the waiting thread.
            invokeCount  = 0;
            autoEvent->Set();
        }
    }
};

ref class TimerExample
{
public:
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        AutoResetEvent^ autoEvent = gcnew AutoResetEvent(false);

        StatusChecker^ statusChecker = gcnew StatusChecker(10);

        // Create a delegate that invokes methods for the timer.
        TimerCallback^ tcb =
           gcnew TimerCallback(statusChecker, &StatusChecker::CheckStatus);

        // 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);
        Timer^ stateTimer = gcnew Timer(tcb, autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent->WaitOne(5000, false);
        stateTimer->Change(0, 500);
        Console::WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent->WaitOne(5000, false);
        stateTimer->~Timer();
        Console::WriteLine("\nDestroying timer.");
    }
};

int main()
{
    TimerExample::Main();
}
// 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.
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 интервал времени задается по истечении.The callback method is invoked once after dueTime elapses, and thereafter each time the time interval specified by period elapses.

Если dueTime значение равно нулю (0), метод обратного вызова вызывается немедленно.If dueTime is zero (0), the callback method is invoked immediately. Если dueTime имеет Timeout.Infiniteзначение, метод обратного вызова никогда не вызывается; таймер отключается, но может быть включен повторно путем Change вызова и указания положительного значения dueTimeдля.If dueTime is Timeout.Infinite, the callback method is never invoked; the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for dueTime.

Если period значение равно нулю (0) Timeout.Infiniteили, dueTime а Timeout.Infiniteне, то метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.If period is zero (0) or Timeout.Infinite, and dueTime is not Timeout.Infinite, the callback method is invoked once; the periodic behavior of the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for period.

Метод может быть вызван TimerCallback из делегата. ChangeThe Change method can be called from the TimerCallback delegate.

Дополнительно

Change(Int64, Int64)

Меняет время запуска и интервал между вызовами метода таймера, используя 64-разрядные знаковые целые числа для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 64-bit signed integers to measure time intervals.

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.The amount of time to delay before the invoking the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера.Specify Infinite to prevent the timer from restarting. Задайте значение ноль (0) для немедленного перезапуска таймера.Specify zero (0) to restart the timer immediately.

period
Int64

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer.The time interval between invocations of the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для отключения периодической сигнализации.Specify Infinite to disable periodic signaling.

Возвраты

Значение true, если таймер успешно обновлен; в противном случае — значение false.true if the timer was successfully updated; otherwise, false.

Исключения

Объект Timer уже был удален.The Timer has already been disposed.

Значение параметра dueTime или period меньше -1.The dueTime or period parameter is less than -1.

Значение параметра dueTime или period больше 4294967294.The dueTime or period parameter is greater than 4294967294.

Комментарии

Метод обратного вызова вызывается один раз dueTime после истечения времени, а затем каждый раз, когда period интервал времени задается по истечении.The callback method is invoked once after dueTime elapses, and thereafter each time the time interval specified by period elapses.

Если dueTime значение равно нулю (0), метод обратного вызова вызывается немедленно.If dueTime is zero (0), the callback method is invoked immediately. Если dueTime имеет Timeout.Infiniteзначение, метод обратного вызова никогда не вызывается; таймер отключается, но может быть включен повторно путем Change вызова и указания положительного значения dueTimeдля.If dueTime is Timeout.Infinite, the callback method is never invoked; the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for dueTime.

Если period значение равно нулю (0) Timeout.Infiniteили, dueTime а Timeout.Infiniteне, то метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.If period is zero (0) or Timeout.Infinite, and dueTime is not Timeout.Infinite, the callback method is invoked once; the periodic behavior of the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for period.

Метод может быть вызван TimerCallback из делегата. ChangeThe Change method can be called from the TimerCallback delegate.

Дополнительно

Change(TimeSpan, TimeSpan)

Меняет время запуска и интервал межу вызовами метода таймера, используя значения объекта TimeSpan для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using TimeSpan values to measure time intervals.

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

Параметры

dueTime
TimeSpan

Объект TimeSpan, представляющий количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer.A TimeSpan representing the amount of time to delay before invoking the callback method specified when the Timer was constructed. Следует задать минус одну (-1) миллисекунду для того, чтобы не допустить повторный запуск таймера.Specify negative one (-1) milliseconds to prevent the timer from restarting. Задайте значение ноль (0) для немедленного перезапуска таймера.Specify zero (0) to restart the timer immediately.

period
TimeSpan

Временной интервал между вызовами метода обратного вызова, определенный в конструкторе объекта Timer.The time interval between invocations of the callback method specified when the Timer was constructed. Следует задать минус одну (-1) миллисекунду для отключения периодической сигнализации.Specify negative one (-1) milliseconds to disable periodic signaling.

Возвраты

Значение true, если таймер успешно обновлен; в противном случае — значение false.true if the timer was successfully updated; otherwise, false.

Исключения

Объект Timer уже был удален.The Timer has already been disposed.

Значение параметра dueTime или period в миллисекундах меньше -1.The dueTime or period parameter, in milliseconds, is less than -1.

Значение параметра dueTime или period в миллисекундах больше 4294967294.The dueTime or period parameter, in milliseconds, is greater than 4294967294.

Примеры

В следующем примере кода показано, как запустить Timer и после заданного числа вызовов изменить его период.The following code example demonstrates how to start a Timer and, after a set number of invocations, change its period.

using namespace System;
using namespace System::Threading;
ref class StatusChecker
{
private:
   int invokeCount;
   int maxCount;

public:
   StatusChecker( int count )
      : invokeCount( 0 ), maxCount( count )
   {}


   // This method is called by the timer delegate.
   void CheckStatus( Object^ stateInfo )
   {
      AutoResetEvent^ autoEvent = dynamic_cast<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();
      }
   }

};

int main()
{
   AutoResetEvent^ autoEvent = gcnew AutoResetEvent( false );
   StatusChecker^ statusChecker = gcnew StatusChecker( 10 );
   
   // Create the delegate that invokes methods for the timer.
   TimerCallback^ timerDelegate = gcnew TimerCallback( statusChecker, &StatusChecker::CheckStatus );
   TimeSpan delayTime = TimeSpan(0,0,1);
   TimeSpan intervalTime = 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 = gcnew Timer( timerDelegate,autoEvent,delayTime,intervalTime );
   
   // When autoEvent signals, change the period to every 1/2 second.
   autoEvent->WaitOne( 5000, false );
   stateTimer->Change( TimeSpan(0), intervalTime + intervalTime );
   Console::WriteLine( "\nChanging period.\n" );
   
   // When autoEvent signals the second time, dispose of the timer.
   autoEvent->WaitOne( 5000, false );
   stateTimer->~Timer();
   Console::WriteLine( "\nDestroying 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 интервал времени задается по истечении.The callback method is invoked once after dueTime elapses, and thereafter each time the time interval specified by period elapses.

Если dueTime значение равно нулю (0), метод обратного вызова вызывается немедленно.If dueTime is zero (0), the callback method is invoked immediately. Если dueTime имеет отрицательное значение (-1) миллисекунд, метод обратного вызова никогда не вызывается; таймер отключается, но может быть включен повторно путем вызова Change и указания положительного значения для dueTime.If dueTime is negative one (-1) milliseconds, the callback method is never invoked; the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for dueTime.

Если period равен нулю (0) или минус 1 (-1) миллисекунды и dueTime является положительным, метод обратного вызова вызывается один раз; периодическое поведение таймера отключается, но его можно включить повторно, вызвав Change и указав значение больше ноль для period.If period is zero (0) or negative one (-1) milliseconds, and dueTime is positive, the callback method is invoked once; the periodic behavior of the timer is disabled, but can be re-enabled by calling Change and specifying a value greater than zero for period.

Метод может быть вызван TimerCallback из делегата. ChangeThe Change method can be called from the TimerCallback delegate.

Дополнительно

Change(UInt32, UInt32)

Важно!

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

Меняет время запуска и интервал между вызовами метода таймера, используя 32-разрядные целые числа без знака для измерения временных интервалов.Changes the start time and the interval between method invocations for a timer, using 32-bit unsigned integers to measure time intervals.

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

Параметры

dueTime
UInt32

Количество времени, в миллисекундах, которое должно пройти до вызова метода ответного вызова при создании объекта Timer.The amount of time to delay before the invoking the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для того, чтобы не допустить повторный запуск таймера.Specify Infinite to prevent the timer from restarting. Задайте значение ноль (0) для немедленного перезапуска таймера.Specify zero (0) to restart the timer immediately.

period
UInt32

Временной интервал в миллисекундах между вызовами метода обратного вызова, определенный в конструкторе объекта Timer.The time interval between invocations of the callback method specified when the Timer was constructed, in milliseconds. Следует задать поле Infinite для отключения периодической сигнализации.Specify Infinite to disable periodic signaling.

Возвраты

Значение true, если таймер успешно обновлен; в противном случае — значение false.true if the timer was successfully updated; otherwise, false.

Атрибуты

Исключения

Объект Timer уже был удален.The Timer has already been disposed.

Комментарии

Метод обратного вызова вызывается один раз dueTime после истечения времени, а затем каждый раз, когда period интервал времени задается по истечении.The callback method is invoked once after dueTime elapses, and thereafter each time the time interval specified by period elapses.

Если dueTime значение равно нулю (0), метод обратного вызова вызывается немедленно.If dueTime is zero (0), the callback method is invoked immediately. Если dueTime имеет Timeout.Infiniteзначение, метод обратного вызова никогда не вызывается; таймер отключается, но может быть включен повторно путем Change вызова и указания положительного значения dueTimeдля.If dueTime is Timeout.Infinite, the callback method is never invoked; the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for dueTime.

Если period значение равно нулю (0) Timeout.Infiniteили, dueTime а Timeout.Infiniteне, то метод обратного вызова вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно, вызвав Change и указав положительное значение для period.If period is zero (0) or Timeout.Infinite, and dueTime is not Timeout.Infinite, the callback method is invoked once; the periodic behavior of the timer is disabled, but can be re-enabled by calling Change and specifying a positive value for period.

Метод может быть вызван TimerCallback из делегата. ChangeThe Change method can be called from the TimerCallback delegate.

Дополнительно

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