Timer (Clase)

El componente Timer es un temporizador basado en servidor que permite especificar un intervalo recurrente en el que se provoca el evento Elapsed en la aplicación. Una vez hecho esto, podrá controlar este evento para proporcionar un procesamiento regular. Por ejemplo, supongamos que un servidor crítico debe mantenerse en funcionamiento las 24 horas del día y los 7 días de la semana. Puede crearse un servicio que utilice Timer para comprobar periódicamente el servidor y asegurarse de que el sistema se encuentra en funcionamiento. Si el sistema no responde, el servicio podría intentar reiniciar el servidor o notificárselo a un administrador.

El Timer basado en servidor está diseñado para utilizarlo con subprocesos de trabajo en un entorno multiproceso. Los temporizadores basados en servidor pueden desplazarse entre subprocesos para controlar el evento Elapsed provocado, dando lugar a una mayor precisión que la proporcionada por los temporizadores de Windows al provocar el evento en el momento exacto.

El componente Timer provoca el evento Elapsed, que se basa en el valor de la propiedad Interval. Puede controlar este evento para ejecutar los procesos que necesite. Por ejemplo, suponga que tiene una aplicación de ventas en línea que envía continuamente pedidos de ventas a una base de datos. El servicio que compila las instrucciones de envío funciona con lotes de pedidos, en lugar de procesar cada pedido individualmente. Se puede utilizar Timer para iniciar el procesamiento de lotes cada 30 minutos.

Nota
Cuando AutoReset se establece en false, Timer provoca el evento Elapsed sólo una vez después de que haya transcurrido el primer intervalo (propiedad Interval). Para seguir provocando al evento Elapsed en la propiedad Interval, se debe establecer la propiedad AutoReset en true.

En .NET Framework versión 2.0 y anteriores, el componente Timer detecta y suprime todas las excepciones producidas por controladores de eventos para el evento Elapsed. Este comportamiento está sujeto a cambios en lanzamientos futuros de .NET Framework.

Si la propiedad SynchronizingObject es null, el evento Elapsed se genera en un subproceso ThreadPool. Si el procesamiento del evento Elapsed dura más que Interval, el evento puede provocarse de nuevo en otro subproceso de ThreadPool. En esta situación, el controlador de eventos debería ser reentrante.

Nota
El método de control de eventos puede ejecutarse en un subproceso al mismo tiempo que otro subproceso llama al método Stop o establece la propiedad Enabled en false. Esto puede dar lugar a que el evento Elapsed se provoque después de detenerse el temporizador. En el ejemplo de código para el método Stop se muestra una forma de evitar esta condición de carrera.

Aun cuando SynchronizingObject no es null, los eventos Elapsed se pueden generar después de Dispose o se ha llamado al método Stop o una vez establecida en false la propiedad Enabled, porque la señal para generar el evento Elapsed siempre se pone en la cola para la ejecución en un subproceso del grupo de subprocesos. Una manera de resolver esta condición de carrera es establecer una marca que indique al controlador de eventos que el evento Elapsed omita los eventos subsiguientes.

Si se utiliza la clase Timer con un elemento de interfaz de usuario, como un formulario o un control, sin colocar el temporizador en un elemento de la interfaz de usuario, se debe asignar el formulario o el control que contiene la clase Timer a la propiedad SynchronizingObject, de modo que se calculen las referencias del evento al subproceso de la interfaz de usuario.

Timer no es visible en tiempo de ejecución.

Para obtener una lista con los valores de propiedad iniciales de una instancia de Timer, vea el constructor Timer.

Nota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de la propiedad Resources: Synchronization | ExternalThreading. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

En el ejemplo de código siguiente se establece un controlador de eventos para el evento Timer.Elapsed y se crea e inicia un temporizador. El controlador de eventos muestra la propiedad SignalTime cada vez que se provoca el evento.

Nota

El código contiene declaraciones de la variable de temporizador en el nivel de clase y dentro de Main. Para ver cómo la recolección de elementos no utilizados agresiva puede afectar a un temporizador que se declara dentro de un método de ejecución prolongada, puede marcar como comentario la declaración del nivel de clase y quitar los comentarios de la variable local. Para evitar recopilar el temporizador, quite las marcas de comentario del método GC.KeepAlive al final de Main.

using System;
using System.Timers;

public class Timer1
{
    private static System.Timers.Timer aTimer;

    public static void Main()
    {
        // Normally, the timer is declared at the class level,
        // so that it stays in scope as long as it is needed.
        // If the timer is declared in a long-running method,  
        // KeepAlive must be used to prevent the JIT compiler 
        // from allowing aggressive garbage collection to occur 
        // before the method ends. You can experiment with this
        // by commenting out the class-level declaration and 
        // uncommenting the declaration below; then uncomment
        // the GC.KeepAlive(aTimer) at the end of the method.
        //System.Timers.Timer aTimer;

        // Create a timer with a ten second interval.
        aTimer = new System.Timers.Timer(10000);

        // Hook up the Elapsed event for the timer.
        aTimer.Elapsed += new ElapsedEventHandler(OnTimedEvent);

        // Set the Interval to 2 seconds (2000 milliseconds).
        aTimer.Interval = 2000;
        aTimer.Enabled = true;

        Console.WriteLine("Press the Enter key to exit the program.");
        Console.ReadLine();

        // If the timer is declared in a long-running method, use
        // KeepAlive to prevent garbage collection from occurring
        // before the method ends.
        //GC.KeepAlive(aTimer);
    }

    // Specify what you want to happen when the Elapsed event is 
    // raised.
    private static void OnTimedEvent(object source, ElapsedEventArgs e)
    {
        Console.WriteLine("The Elapsed event was raised at {0}", e.SignalTime);
    }
}

/* This code example produces output similar to the following:

Press the Enter key to exit the program.
The Elapsed event was raised at 5/20/2007 8:42:27 PM
The Elapsed event was raised at 5/20/2007 8:42:29 PM
The Elapsed event was raised at 5/20/2007 8:42:31 PM
...
 */

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Todos los miembros static públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Referencia