Timer.Change Timer.Change Timer.Change Timer.Change Method

定義

タイマーの開始時刻とメソッドの呼び出しの間隔を変更します。Changes the start time and the interval between method invocations for a timer.

オーバーロード

Change(Int32, Int32) Change(Int32, Int32) Change(Int32, Int32) 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) Change(Int64, Int64) Change(Int64, Int64) 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) Change(TimeSpan, TimeSpan) Change(TimeSpan, TimeSpan) 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) Change(UInt32, UInt32) Change(UInt32, UInt32) 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) Change(Int32, Int32) Change(Int32, Int32) 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 Int32 Int32 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 Int32 Int32 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。それ以外の場合は falsetrue 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に1回呼び出され、その後、によっ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 Change dueTimeの場合、コールバックメソッドは呼び出されません。タイマーは無効になりますが、を呼び出し、に正の値を指定することによって、再度有効にすることができます。 Timeout.InfiniteIf 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でない場合は、コールバックメソッドが1回だけ呼び出されます。タイマーの周期的な動作は無効にChangeなりますが、を呼び出し、の正の値を指定することによって、再度有効にすることができますperiodIf 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.

メソッドChangeは、 TimerCallbackデリゲートから呼び出すことができます。The Change method can be called from the TimerCallback delegate.

こちらもご覧ください

Change(Int64, Int64) Change(Int64, Int64) Change(Int64, Int64) 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 Int64 Int64 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 Int64 Int64 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。それ以外の場合は falsetrue 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に1回呼び出され、その後、によっ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 Change dueTimeの場合、コールバックメソッドは呼び出されません。タイマーは無効になりますが、を呼び出し、に正の値を指定することによって、再度有効にすることができます。 Timeout.InfiniteIf 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でない場合は、コールバックメソッドが1回だけ呼び出されます。タイマーの周期的な動作は無効にChangeなりますが、を呼び出し、の正の値を指定することによって、再度有効にすることができますperiodIf 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.

メソッドChangeは、 TimerCallbackデリゲートから呼び出すことができます。The Change method can be called from the TimerCallback delegate.

こちらもご覧ください

Change(TimeSpan, TimeSpan) Change(TimeSpan, TimeSpan) Change(TimeSpan, TimeSpan) 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 TimeSpan 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 TimeSpan TimeSpan 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。それ以外の場合は falsetrue 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に1回呼び出され、その後、によっ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 (-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で、が正の場合は、コールバックメソッドが1回だけ呼び出されます。タイマーの周期的な動作は無効Changeになりますが、を呼び出し、を超える値を指定することによって、再度有効にすることができます。の場合periodは0。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.

メソッドChangeは、 TimerCallbackデリゲートから呼び出すことができます。The Change method can be called from the TimerCallback delegate.

こちらもご覧ください

Change(UInt32, UInt32) Change(UInt32, UInt32) Change(UInt32, UInt32) 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 UInt32 UInt32 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 UInt32 UInt32 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。それ以外の場合は falsetrue if the timer was successfully updated; otherwise, false.

例外

Timer が既に破棄されています。The Timer has already been disposed.

注釈

コールバックメソッドは、経過後dueTimeに1回呼び出され、その後、によっ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 Change dueTimeの場合、コールバックメソッドは呼び出されません。タイマーは無効になりますが、を呼び出し、に正の値を指定することによって、再度有効にすることができます。 Timeout.InfiniteIf 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でない場合は、コールバックメソッドが1回だけ呼び出されます。タイマーの周期的な動作は無効にChangeなりますが、を呼び出し、の正の値を指定することによって、再度有効にすることができますperiodIf 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.

メソッドChangeは、 TimerCallbackデリゲートから呼び出すことができます。The Change method can be called from the TimerCallback delegate.

こちらもご覧ください

適用対象