Timer.Change Metode

Referensi

Definisi

Ruang nama:: System.Threading

Rakitan:: System.Threading.Timer.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer.

Overload

Change(Int32, Int32)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda 32-bit untuk mengukur interval waktu.
Change(Int64, Int64)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda 64-bit untuk mengukur interval waktu.
Change(TimeSpan, TimeSpan)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan TimeSpan nilai untuk mengukur interval waktu.
Change(UInt32, UInt32)	Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat yang tidak ditandatangani 32-bit untuk mengukur interval waktu.

Change(Int32, Int32)

Sumber:: Timer.cs

Sumber:: Timer.cs

Sumber:: Timer.cs

Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda 32-bit untuk mengukur interval waktu.

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

Parameter

dueTime: Int32

Jumlah waktu untuk menunda sebelum memanggil metode panggilan balik yang ditentukan ketika Timer dibangun, dalam milidetik. Tentukan Infinite untuk mencegah timer dimulai ulang. Tentukan nol (0) untuk segera memulai ulang timer.

period: Int32

Interval waktu antara pemanggilan metode panggilan balik yang ditentukan ketika Timer dibangun, dalam milidetik. Tentukan Infinite untuk menonaktifkan sinyal berkala.

Mengembalikan

Boolean

true jika timer berhasil diperbarui; jika tidak, false.

Pengecualian

ObjectDisposedException

Timer sudah dibuang.

ArgumentOutOfRangeException

Parameter dueTime atau period negatif dan tidak sama dengan Infinite.

Contoh

Contoh kode berikut menunjukkan cara memulai Timer dan, setelah sejumlah pemanggilan yang ditetapkan, ubah periodenya.

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.

Keterangan

Metode panggilan balik dipanggil sekali setelah dueTime berlalu, dan setelah itu setiap kali interval waktu yang ditentukan oleh period berlalu.

Jika dueTime nol (0), metode panggilan balik segera dipanggil. Jika dueTime adalah Timeout.Infinite, metode panggilan balik tidak pernah dipanggil; timer dinonaktifkan, tetapi dapat diaktifkan kembali dengan memanggil Change dan menentukan nilai positif untuk dueTime.

Jika period nol (0) atau Timeout.Infinite, dan dueTime bukan Timeout.Infinite, metode panggilan balik dipanggil sekali; perilaku berkala timer dinonaktifkan, tetapi dapat diaktifkan kembali dengan memanggil Change dan menentukan nilai positif untuk period.

Metode Change ini dapat dipanggil dari TimerCallback delegasi.

Lihat juga

Timer

Berlaku untuk

Change(Int64, Int64)

Sumber:: Timer.cs

Sumber:: Timer.cs

Sumber:: Timer.cs

Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat bertanda 64-bit untuk mengukur interval waktu.

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

Parameter

dueTime: Int64

period: Int64

Interval waktu antara pemanggilan metode panggilan balik yang ditentukan ketika Timer dibangun, dalam milidetik. Tentukan Infinite untuk menonaktifkan sinyal berkala.

Mengembalikan

Boolean

true jika timer berhasil diperbarui; jika tidak, false.

Pengecualian

ObjectDisposedException

Timer sudah dibuang.

ArgumentOutOfRangeException

dueTime atau period kurang dari -1.

-atau-

dueTime atau period lebih besar dari 4294967294.

Keterangan

Metode panggilan balik dipanggil sekali setelah dueTime berlalu, dan setelah itu setiap kali interval waktu yang ditentukan oleh period berlalu.

Metode Change ini dapat dipanggil dari TimerCallback delegasi.

Lihat juga

Timer

Berlaku untuk

Change(TimeSpan, TimeSpan)

Sumber:: Timer.cs

Sumber:: Timer.cs

Sumber:: Timer.cs

Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan TimeSpan nilai untuk mengukur interval waktu.

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

Parameter

dueTime: TimeSpan

yang TimeSpan mewakili jumlah waktu untuk menunda sebelum memanggil metode panggilan balik yang ditentukan ketika Timer dibangun. Tentukan InfiniteTimeSpan untuk mencegah timer dimulai ulang. Tentukan Zero untuk segera memulai ulang timer.

period: TimeSpan

Interval waktu antara pemanggilan metode panggilan balik yang ditentukan ketika Timer dibangun. Tentukan InfiniteTimeSpan untuk menonaktifkan sinyal berkala.

Mengembalikan

Boolean

true jika timer berhasil diperbarui; jika tidak, false.

Penerapan

Change(TimeSpan, TimeSpan)

Pengecualian

ObjectDisposedException

Timer sudah dibuang.

ArgumentOutOfRangeException

Parameter dueTime atau period , dalam milidetik, kurang dari -1.

NotSupportedException

Parameter dueTime atau period , dalam milidetik, lebih besar dari 4294967294.

Contoh

Contoh kode berikut menunjukkan cara memulai Timer dan, setelah sejumlah pemanggilan yang ditetapkan, ubah periodenya.

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

Keterangan

Metode panggilan balik dipanggil sekali setelah dueTime berlalu, dan setelah itu setiap kali interval waktu yang ditentukan oleh period berlalu.

Jika dueTime adalah TimeSpan.Zero, metode panggilan balik segera dipanggil. Jika dueTime adalah InfiniteTimeSpan, metode panggilan balik tidak pernah dipanggil; timer dinonaktifkan, tetapi dapat diaktifkan kembali dengan memanggil Change dan menentukan nilai positif untuk dueTime.

Jika period adalah TimeSpan.Zero atau InfiniteTimeSpan, dan dueTime positif, metode panggilan balik dipanggil sekali; perilaku berkala timer dinonaktifkan, tetapi dapat diaktifkan kembali dengan memanggil Change dan menentukan nilai yang lebih besar dari nol untuk period.

Metode Change ini dapat dipanggil dari TimerCallback delegasi.

Lihat juga

Timer

Berlaku untuk

Change(UInt32, UInt32)

Sumber:: Timer.cs

Sumber:: Timer.cs

Sumber:: Timer.cs

Penting

API ini bukan kompatibel CLS.

Mengubah waktu mulai dan interval antara pemanggilan metode untuk timer, menggunakan bilangan bulat yang tidak ditandatangani 32-bit untuk mengukur interval waktu.

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

Parameter

dueTime: UInt32

period: UInt32

Interval waktu antara pemanggilan metode panggilan balik yang ditentukan ketika Timer dibangun, dalam milidetik. Tentukan Infinite untuk menonaktifkan sinyal berkala.

Mengembalikan

Boolean

true jika timer berhasil diperbarui; jika tidak, false.

Atribut: CLSCompliantAttribute

Pengecualian

ObjectDisposedException

Timer sudah dibuang.

Keterangan

Metode panggilan balik dipanggil sekali setelah dueTime berlalu, dan setelah itu setiap kali interval waktu yang ditentukan oleh period berlalu.

Metode Change ini dapat dipanggil dari TimerCallback delegasi.

Lihat juga

Timer

Berlaku untuk

Bagikan melalui

Timer.Change Metode

Definisi

Overload

Change(Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Change(Int64, Int64)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Change(TimeSpan, TimeSpan)

Parameter

Mengembalikan

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Change(UInt32, UInt32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: