Timer.Change Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Runtime.dll

Změní čas spuštění a interval mezi vyvoláním metody pro časovač.

Přetížení

Name	Description
Change(Int32, Int32)	Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 32bitových celých čísel se znaménkem k měření časových intervalů.
Change(Int64, Int64)	Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 64bitových znaménka k měření časových intervalů.
Change(TimeSpan, TimeSpan)	Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí TimeSpan hodnot k měření časových intervalů.
Change(UInt32, UInt32)	Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 32bitových celých čísel bez znaménka k měření časových intervalů.

Change(Int32, Int32)

Zdroj:

Timer.cs

Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 32bitových celých čísel se znaménkem k měření časových intervalů.

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

Doba zpoždění před vyvoláním metody zpětného volání zadanou při Timer vytvoření v milisekundách. Zadejte Infinite , aby se zabránilo restartování časovače. Zadejte nulu (0) pro okamžité restartování časovače.

period

Int32

Časový interval mezi vyvoláním metody zpětného volání zadanou při Timer vytváření v milisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Návraty

Boolean

truepokud časovač byl úspěšně aktualizován; v opačném případě . false

Výjimky

ObjectDisposedException

Již Timer byl odstraněn.

ArgumentOutOfRangeException

Nebo dueTimeperiod parametr je záporný a není roven Infinite.

Příklady

Následující příklad kódu ukazuje, jak spustit a Timer po nastaveném počtu vyvolání změnit jeho období.

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.

Poznámky

Metoda zpětného volání je vyvolána jednou po dueTime uplynutí a následně pokaždé, když časový interval určený period uplynulými.

Pokud dueTime je nula (0), volá se metoda zpětného volání okamžitě. Pokud dueTime je Timeout.Infinite, zpětné volání metoda není nikdy vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro dueTime.

Pokud period je nula (0) nebo Timeout.Infinitea dueTime není Timeout.Infinite, metoda zpětného volání je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro period.

Metodu Change lze volat z delegáta TimerCallback .

Viz také

• Časovače

Change(Int64, Int64)

Zdroj:

Timer.cs

Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 64bitových znaménka k měření časových intervalů.

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

Doba zpoždění před vyvoláním metody zpětného volání zadanou při Timer vytvoření v milisekundách. Zadejte Infinite , aby se zabránilo restartování časovače. Zadejte nulu (0) pro okamžité restartování časovače. Tato hodnota musí být menší nebo rovna 4294967294.

period

Int64

Časový interval mezi vyvoláním metody zpětného volání zadanou při Timer vytváření v milisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Návraty

Boolean

truepokud časovač byl úspěšně aktualizován; v opačném případě . false

Výjimky

ObjectDisposedException

Již Timer byl odstraněn.

ArgumentOutOfRangeException

dueTime nebo period je menší než -1.

nebo

dueTime nebo period je větší než 4294967294.

Poznámky

Metoda zpětného volání je vyvolána jednou po dueTime uplynutí a následně pokaždé, když časový interval určený period uplynulými.

Pokud dueTime je nula (0), volá se metoda zpětného volání okamžitě. Pokud dueTime je Timeout.Infinite, zpětné volání metoda není nikdy vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro dueTime.

Pokud period je nula (0) nebo Timeout.Infinitea dueTime není Timeout.Infinite, metoda zpětného volání je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro period.

Metodu Change lze volat z delegáta TimerCallback .

Viz také

• Časovače

Change(TimeSpan, TimeSpan)

Zdroj:

Timer.cs

Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí TimeSpan hodnot k měření časových intervalů.

public:
 virtual bool Change(TimeSpan dueTime, TimeSpan period);

public bool Change(TimeSpan dueTime, TimeSpan period);

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

Představuje TimeSpan dobu zpoždění před vyvoláním metody zpětného volání zadanou při Timer vytvoření. Zadejte InfiniteTimeSpan , aby se zabránilo restartování časovače. Zadejte Zero , aby se časovač okamžitě restartoval.

period

TimeSpan

Časový interval mezi vyvoláním metody zpětného volání určenou při Timer vytváření. Určete InfiniteTimeSpan , že chcete zakázat pravidelné signály.

Návraty

Boolean

truepokud časovač byl úspěšně aktualizován; v opačném případě . false

Implementuje

Change(TimeSpan, TimeSpan)

Výjimky

ObjectDisposedException

Již Timer byl odstraněn.

ArgumentOutOfRangeException

Parametr dueTime v period milisekundách je menší než -1.

NotSupportedException

Parametr dueTime v period milisekundách je větší než 4294967294.

Příklady

Následující příklad kódu ukazuje, jak spustit a Timer po nastaveném počtu vyvolání změnit jeho období.

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

Poznámky

Metoda zpětného volání je vyvolána jednou po dueTime uplynutí a následně pokaždé, když časový interval určený period uplynulými.

Pokud dueTime je TimeSpan.Zero, metoda zpětného volání je vyvolána okamžitě. Pokud dueTime je InfiniteTimeSpan, zpětné volání metoda není nikdy vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro dueTime.

Pokud period je TimeSpan.Zero nebo InfiniteTimeSpan, a je dueTime pozitivní, callback metoda je vyvolána jednou; pravidelné chování časovače je zakázáno, ale může být znovu povoleno voláním Change a určením hodnoty větší než nula pro period.

Metodu Change lze volat z delegáta TimerCallback .

Viz také

• Časovače

Change(UInt32, UInt32)

Zdroj:

Timer.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Změní čas spuštění a interval mezi vyvoláním metody pro časovač pomocí 32bitových celých čísel bez znaménka k měření časových intervalů.

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

Doba zpoždění před vyvoláním metody zpětného volání zadanou při Timer vytvoření v milisekundách. Zadejte Infinite , aby se zabránilo restartování časovače. Zadejte nulu (0) pro okamžité restartování časovače.

period

UInt32

Časový interval mezi vyvoláním metody zpětného volání zadanou při Timer vytváření v milisekundách. Určete Infinite , že chcete zakázat pravidelné signály.

Návraty

Boolean

truepokud časovač byl úspěšně aktualizován; v opačném případě . false

Atributy

CLSCompliantAttribute

Výjimky

ObjectDisposedException

Již Timer byl odstraněn.

Poznámky

Metoda zpětného volání je vyvolána jednou po dueTime uplynutí a následně pokaždé, když časový interval určený period uplynulými.

Pokud dueTime je nula (0), volá se metoda zpětného volání okamžitě. Pokud dueTime je Timeout.Infinite, zpětné volání metoda není nikdy vyvolána; časovač je zakázán, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro dueTime.

Pokud period je nula (0) nebo Timeout.Infinitea dueTime není Timeout.Infinite, metoda zpětného volání je vyvolána jednou; pravidelné chování časovače je zakázáno, ale lze jej znovu povolit voláním Change a určením kladné hodnoty pro period.

Metodu Change lze volat z delegáta TimerCallback .

Viz také

• Časovače