Timer.Change 方法

參考

定義

命名空間:: System.Threading

組件:: System.Threading.Timer.dll

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

變更開始的時間和計時器的方法引動過程之間的時間間隔。

多載

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

變更開始的時間和計時器的方法引動過程之間的時間間隔，使用 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 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 指定的時間間隔之後叫用一次。

如果 dueTime 為零 (0) ，則會立即叫用回呼方法。如果 dueTime 為 Timeout.Infinite ，則永遠不會叫用回呼方法;計時器已停用，但可以藉由呼叫 Change 並指定的 dueTime 正值來重新啟用。

如果 period 為零 (0) 或 Timeout.Infinite ，且 dueTime 不是 Timeout.Infinite ，則會叫用回呼方法一次;計時器定期行為會停用，但可以呼叫並指定的 period 正值來重新啟用 Change 。

Change您可以從委派呼叫 TimerCallback 方法。

另請參閱

計時器

適用於

Change(Int64, Int64)

來源:: 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 指定的時間間隔之後叫用一次。

Change您可以從委派呼叫 TimerCallback 方法。

另請參閱

計時器

適用於

Change(TimeSpan, TimeSpan)

來源:: 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 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 指定的時間間隔之後叫用一次。

如果為 dueTimeTimeSpan.Zero ，則會立即叫用回呼方法。如果 dueTime 為 InfiniteTimeSpan ，則永遠不會叫用回呼方法;計時器已停用，但可以藉由呼叫 Change 並指定的 dueTime 正值來重新啟用。

如果 period 為 TimeSpan.Zero 或 InfiniteTimeSpan ，且 dueTime 為正數，則會叫用回呼方法一次;計時器定期行為會停用，但可以呼叫並指定大於零的值 period 來重新啟用 Change 。

Change您可以從委派呼叫 TimerCallback 方法。

另請參閱

計時器

適用於

Change(UInt32, UInt32)

來源:: 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

period: UInt32

建構 Timer 時指定的回呼方法的引動過程間隔時間 (以毫秒為單位)。指定 Infinite 以停用週期的信號功能。

傳回

Boolean

如果已成功更新計時器，則為 true，否則為 false。

屬性: CLSCompliantAttribute

例外狀況

ObjectDisposedException

Timer 已經處置。

備註

回呼方法會在經過之後 dueTime 叫用一次，並在每次經過所 period 指定的時間間隔之後叫用一次。

Change您可以從委派呼叫 TimerCallback 方法。

另請參閱

計時器

適用於

共用方式為

Timer.Change 方法

定義

多載

Change(Int32, Int32)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Change(Int64, Int64)

參數

傳回

例外狀況

備註

另請參閱

適用於

Change(TimeSpan, TimeSpan)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

Change(UInt32, UInt32)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源