Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Timer.Change (Int32, Int32)

 

Publicado: octubre de 2016

Cambia el tiempo de inicio y el intervalo entre las distintas invocaciones de método para un temporizador, utilizando enteros de 32 bits con signo para medir los intervalos de tiempo.

Espacio de nombres:   System.Threading
Ensamblado:  mscorlib (en mscorlib.dll)

public bool Change(
	int dueTime,
	int period
)

Parámetros

dueTime
Type: System.Int32

La cantidad de tiempo de retraso antes de invocar el método de devolución de llamada especificado cuando el Timer se construyó en milisegundos. Especificar Timeout.Infinite para evitar que el temporizador se reinicie. Especifique cero (0) para reiniciar inmediatamente el temporizador.

period
Type: System.Int32

Especifica el intervalo de tiempo entre invocaciones del método de devolución de llamada cuando el Timer se construyó en milisegundos. Especificar Timeout.Infinite para deshabilitar la señalización periódica.

Valor devuelto

Type: System.Boolean

true Si el temporizador se actualizó correctamente; de lo contrario, false.

Exception Condition
ObjectDisposedException

El Timer ya se ha eliminado.

ArgumentOutOfRangeException

El dueTime o period parámetro es negativo y no es igual a Timeout.Infinite.

El método de devolución de llamada se invoca después dueTime transcurre y posteriormente cada vez el intervalo de tiempo especificado por period transcurre.

Si dueTime es cero (0), se invoca el método de devolución de llamada inmediatamente. Si dueTime es Timeout.Infinite, nunca se invoca el método de devolución de llamada; el temporizador está desactivado, pero puede volver a habilitarse mediante una llamada a Change y especificando un valor positivo para dueTime.

Si period es cero (0) o Timeout.Infinite, y dueTime no Timeout.Infinite, se invoca el método de devolución de llamada una vez; el comportamiento periódico del temporizador se deshabilita, pero puede volver a habilitarse mediante una llamada a Change y especificando un valor positivo para period.

El Change método puede llamarse desde el TimerCallback delegar.

En el ejemplo de código siguiente se muestra cómo iniciar un Timer y, después de un número establecido de llamadas, cambiar su período.

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.

Plataforma universal de Windows
Disponible desde 8.1
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: