Timer.Change Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Threading

Zestaw:: System.Threading.Timer.dll

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zmienia godzinę rozpoczęcia i interwał między wywołaniami metody dla czasomierza.

Przeciążenia

Change(Int32, Int32)	Zmienia czas rozpoczęcia i interwał między wywołaniami metody dla czasomierza, używając 32-bitowych liczb całkowitych ze znakiem w celu mierzenia interwałów czasu.
Change(Int64, Int64)	Zmienia czas rozpoczęcia i interwał między wywołaniami metod dla czasomierza, używając 64-bitowych liczb całkowitych ze znakiem w celu mierzenia interwałów czasu.
Change(TimeSpan, TimeSpan)	Zmienia czas rozpoczęcia i interwał między wywołaniami metody dla czasomierza, używając TimeSpan wartości do mierzenia interwałów czasu.
Change(UInt32, UInt32)	Zmienia czas rozpoczęcia i interwał między wywołaniami metod dla czasomierza, używając 32-bitowych liczb całkowitych bez znaku, aby mierzyć interwały czasu.

Change(Int32, Int32)

Źródło:: Timer.cs

Źródło:: Timer.cs

Źródło:: Timer.cs

Zmienia czas rozpoczęcia i interwał między wywołaniami metody dla czasomierza, używając 32-bitowych liczb całkowitych ze znakiem w celu mierzenia interwałów czasu.

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

Parametry

dueTime: Int32

Czas opóźnienia przed wywołaniem metody wywołania zwrotnego określonego podczas Timer konstruowania metody w milisekundach. Określ, Infinite aby uniemożliwić ponowne uruchomienie czasomierza. Określ zero (0), aby natychmiast ponownie uruchomić czasomierz.

period: Int32

Interwał czasu między wywołaniami metody wywołania zwrotnego określonego podczas Timer konstruowania metody w milisekundach. Określ, Infinite aby wyłączyć okresowe sygnały.

Zwraca

Boolean

true jeśli czasomierz został pomyślnie zaktualizowany; w przeciwnym razie , false.

Wyjątki

ObjectDisposedException

Został Timer już usunięty.

ArgumentOutOfRangeException

Parametr dueTime or period jest ujemny i nie jest równy Infinite.

Przykłady

W poniższym przykładzie kodu pokazano, jak uruchomić element Timer i po ustawieniu liczby wywołań zmień jego okres.

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.

Uwagi

Metoda wywołania zwrotnego jest wywoływana raz po dueTime upływie, a następnie za każdym razem, gdy upłynął interwał czasu określony przez period czas.

Jeśli dueTime jest zero (0), metoda wywołania zwrotnego jest wywoływana natychmiast. Jeśli dueTime jest Timeout.Infiniteto , metoda wywołania zwrotnego nigdy nie jest wywoływana; czasomierz jest wyłączony, ale można go ponownie włączyć przez wywołanie Change i określenie wartości dodatniej dla dueTime.

Jeśli period jest zero (0) lub Timeout.Infinite, i dueTime nie Timeout.Infinitejest , metoda wywołania zwrotnego jest wywoływana raz; okresowe zachowanie czasomierza jest wyłączone, ale można je ponownie włączyć przez wywołanie Change i określenie wartości dodatniej dla period.

Metodę Change można wywołać z delegata TimerCallback .

Zobacz też

Czasomierze

Dotyczy

Change(Int64, Int64)

Źródło:: Timer.cs

Źródło:: Timer.cs

Źródło:: Timer.cs

Zmienia czas rozpoczęcia i interwał między wywołaniami metod dla czasomierza, używając 64-bitowych liczb całkowitych ze znakiem w celu mierzenia interwałów czasu.

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

Parametry

dueTime: Int64

period: Int64

Interwał czasu między wywołaniami metody wywołania zwrotnego określonego podczas Timer konstruowania metody w milisekundach. Określ, Infinite aby wyłączyć okresowe sygnały.

Zwraca

Boolean

true jeśli czasomierz został pomyślnie zaktualizowany; w przeciwnym razie , false.

Wyjątki

ObjectDisposedException

Został Timer już usunięty.

ArgumentOutOfRangeException

dueTime lub period jest mniejszy niż -1.

-lub-

dueTime lub period jest większy niż 4294967294.

Uwagi

Metoda wywołania zwrotnego jest wywoływana raz po dueTime upływie, a następnie za każdym razem, gdy upłynął interwał czasu określony przez period czas.

Metodę Change można wywołać z delegata TimerCallback .

Zobacz też

Czasomierze

Dotyczy

Change(TimeSpan, TimeSpan)

Źródło:: Timer.cs

Źródło:: Timer.cs

Źródło:: Timer.cs

Zmienia czas rozpoczęcia i interwał między wywołaniami metody dla czasomierza, używając TimeSpan wartości do mierzenia interwałów czasu.

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

Parametry

dueTime: TimeSpan

Reprezentująca TimeSpan czas opóźnienia przed wywołaniem metody wywołania zwrotnego określonego Timer podczas konstruowania. Określ, InfiniteTimeSpan aby uniemożliwić ponowne uruchomienie czasomierza. Określ, Zero aby natychmiast uruchomić czasomierz.

period: TimeSpan

Interwał czasu między wywołaniami metody wywołania zwrotnego określonego podczas Timer konstruowania. Określ, InfiniteTimeSpan aby wyłączyć okresowe sygnały.

Zwraca

Boolean

true jeśli czasomierz został pomyślnie zaktualizowany; w przeciwnym razie , false.

Implementuje

Change(TimeSpan, TimeSpan)

Wyjątki

ObjectDisposedException

Został Timer już usunięty.

ArgumentOutOfRangeException

Parametr dueTime or period w milisekundach jest mniejszy niż -1.

NotSupportedException

Parametr dueTime or period w milisekundach jest większy niż 4294967294.

Przykłady

W poniższym przykładzie kodu pokazano, jak uruchomić element Timer i po ustawieniu liczby wywołań zmień jego okres.

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

Uwagi

Metoda wywołania zwrotnego jest wywoływana raz po dueTime upływie, a następnie za każdym razem, gdy upłynął interwał czasu określony przez period czas.

Jeśli dueTime jest to TimeSpan.Zero, metoda wywołania zwrotnego jest wywoływana natychmiast. Jeśli dueTime jest InfiniteTimeSpanto , metoda wywołania zwrotnego nigdy nie jest wywoływana; czasomierz jest wyłączony, ale można go ponownie włączyć przez wywołanie Change i określenie wartości dodatniej dla dueTime.

Jeśli period jest TimeSpan.Zero lub InfiniteTimeSpan, i dueTime jest dodatni, metoda wywołania zwrotnego jest wywoływana raz; okresowe zachowanie czasomierza jest wyłączone, ale można ponownie włączyć przez wywołanie Change i określenie wartości większej niż zero dla period.

Metodę Change można wywołać z delegata TimerCallback .

Zobacz też

Czasomierze

Dotyczy

Change(UInt32, UInt32)

Źródło:: Timer.cs

Źródło:: Timer.cs

Źródło:: Timer.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zmienia czas rozpoczęcia i interwał między wywołaniami metod dla czasomierza, używając 32-bitowych liczb całkowitych bez znaku, aby mierzyć interwały czasu.

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

Parametry

dueTime: UInt32

period: UInt32

Interwał czasu między wywołaniami metody wywołania zwrotnego określonego podczas Timer konstruowania metody w milisekundach. Określ, Infinite aby wyłączyć okresowe sygnały.

Zwraca

Boolean

true jeśli czasomierz został pomyślnie zaktualizowany; w przeciwnym razie , false.

Atrybuty: CLSCompliantAttribute

Wyjątki

ObjectDisposedException

Został Timer już usunięty.

Uwagi

Metoda wywołania zwrotnego jest wywoływana raz po dueTime upływie, a następnie za każdym razem, gdy upłynął interwał czasu określony przez period czas.

Metodę Change można wywołać z delegata TimerCallback .

Zobacz też

Czasomierze

Dotyczy

Udostępnij za pośrednictwem

Timer.Change Metoda

Definicja

Przeciążenia

Change(Int32, Int32)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Change(Int64, Int64)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

Change(TimeSpan, TimeSpan)

Parametry

Zwraca

Implementuje

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Change(UInt32, UInt32)

Parametry

Zwraca

Wyjątki

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby