Timer Clase

Definición

Proporciona un mecanismo para ejecutar un método en un subproceso de grupo de subprocesos a intervalos especificados. Esta clase no se puede heredar.

public ref class Timer sealed : IDisposable
public ref class Timer sealed : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class Timer sealed : MarshalByRefObject, System::Threading::ITimer
public ref class Timer sealed : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : IDisposable
public sealed class Timer : MarshalByRefObject, IAsyncDisposable, IDisposable
public sealed class Timer : MarshalByRefObject, System.Threading.ITimer
public sealed class Timer : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : MarshalByRefObject, IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    interface IDisposable
type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
type Timer = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
    interface ITimer
type Timer = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type Timer = class
    inherit MarshalByRefObject
    interface IDisposable
Public NotInheritable Class Timer
Implements IDisposable
Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements ITimer
Public NotInheritable Class Timer
Inherits MarshalByRefObject
Implements IDisposable
Herencia
Timer
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se define una clase StatusChecker que incluye un método CheckStatus cuya firma es la misma que el delegado de TimerCallback. El argumento state del método CheckStatus es un objeto AutoResetEvent que se usa para sincronizar el subproceso de aplicación y el subproceso del grupo de subprocesos que ejecuta el delegado de devolución de llamada. La clase StatusChecker también incluye dos variables de estado:

invokeCount Indica el número de veces que se ha invocado el método de devolución de llamada.

maxCount Determina el número máximo de veces que se debe invocar el método de devolución de llamada.

El subproceso de aplicación crea el temporizador, que espera un segundo y, a continuación, ejecuta el método de devolución de llamada CheckStatus cada 250 milisegundos. A continuación, el subproceso de aplicación se bloquea hasta que se señale el objeto AutoResetEvent. Cuando el método de devolución de llamada CheckStatus se ejecuta maxCount veces, llama al método AutoResetEvent.Set para establecer el estado del objeto AutoResetEvent en señalizado. La primera vez que esto sucede, el subproceso de aplicación llama al método Change(Int32, Int32) para que el método de devolución de llamada se ejecute ahora cada medio segundo. Una vez más se bloquea hasta que se señala el objeto AutoResetEvent. Cuando esto sucede, el temporizador se destruye llamando a su método Dispose y la aplicación finaliza.

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.

Comentarios

Use un delegado TimerCallback para especificar el método que desea que se ejecute el Timer. La firma del delegado de TimerCallback es:

void TimerCallback(Object state)
void TimerCallback(Object state)
Sub TimerCallback(state As Object)

El delegado del temporizador se especifica cuando se construye el temporizador y no se puede cambiar. El método no se ejecuta en el subproceso que creó el temporizador; se ejecuta en un subproceso de ThreadPool proporcionado por el sistema.

Propina

.NET incluye varias clases de temporizador, cada una de las cuales ofrece una funcionalidad diferente:

  • System.Timers.Timer, que desencadena un evento y ejecuta el código en uno o varios receptores de eventos a intervalos regulares. La clase está pensada para su uso como componente de servicio o basado en servidor en un entorno multiproceso; no tiene ninguna interfaz de usuario y no está visible en tiempo de ejecución.
  • System.Threading.Timer, que ejecuta un único método de devolución de llamada en un subproceso de grupo de subprocesos a intervalos regulares. El método de devolución de llamada se define cuando se crea una instancia del temporizador y no se puede cambiar. Al igual que la clase System.Timers.Timer, esta clase está pensada para su uso como componente de servicio o basado en servidor en un entorno multiproceso; no tiene ninguna interfaz de usuario y no está visible en tiempo de ejecución.
  • System.Windows.Forms.Timer, un componente de Windows Forms que activa un evento y ejecuta el código en uno o varios receptores de eventos a intervalos regulares. El componente no tiene interfaz de usuario y está diseñado para su uso en un entorno de un solo subproceso; se ejecuta en el subproceso de la interfaz de usuario.
  • System.Web.UI.Timer (solo .NET Framework), un componente de ASP.NET que realiza postbacks de página web asincrónicas o sincrónicas a intervalos regulares.
  • System.Windows.Threading.DispatcherTimer, un temporizador integrado en la cola de Dispatcher. Este temporizador se procesa con una prioridad especificada en un intervalo de tiempo especificado.

Al crear un temporizador, puede especificar una cantidad de tiempo para esperar antes de la primera ejecución del método (tiempo de vencimiento) y una cantidad de tiempo para esperar entre ejecuciones posteriores (período). La clase Timer tiene la misma resolución que el reloj del sistema. Esto significa que si el período es menor que la resolución del reloj del sistema, el delegado de TimerCallback se ejecutará a intervalos definidos por la resolución del reloj del sistema, que es de aproximadamente 15 milisegundos en los sistemas Windows 7 y Windows 8. Puede cambiar el tiempo y el período de vencimiento, o deshabilitar el temporizador, mediante el método Change.

Nota

Siempre que use una Timer, debe mantener una referencia a ella. Al igual que con cualquier objeto administrado, un Timer está sujeto a la recolección de elementos no utilizados cuando no hay referencias a él. El hecho de que un Timer todavía está activo no impide que se recopile.

Nota

El reloj del sistema que se usa es el mismo reloj usado por GetTickCount, que no se ve afectado por los cambios realizados con timeBeginPeriod y timeEndPeriod.

Cuando ya no se necesite un temporizador, use el método Dispose para liberar los recursos mantenidos por el temporizador. Tenga en cuenta que las devoluciones de llamada pueden producirse después de llamar a la sobrecarga del método Dispose(), porque el temporizador pone en cola devoluciones de llamada para su ejecución por subprocesos del grupo de subprocesos. Puede usar la sobrecarga del método Dispose(WaitHandle) para esperar hasta que se hayan completado todas las devoluciones de llamada.

El método de devolución de llamada ejecutado por el temporizador debe ser reentrant, ya que se llama a en ThreadPool subprocesos. La devolución de llamada se puede ejecutar simultáneamente en dos subprocesos del grupo de subprocesos si el intervalo del temporizador es menor que el tiempo necesario para ejecutar la devolución de llamada, o si todos los subprocesos del grupo de subprocesos están en uso y la devolución de llamada se pone en cola varias veces.

Nota

System.Threading.Timer es un temporizador sencillo y ligero que usa métodos de devolución de llamada y que los subprocesos del grupo de subprocesos sirven. No se recomienda usar con Windows Forms, ya que sus devoluciones de llamada no se producen en el subproceso de la interfaz de usuario. System.Windows.Forms.Timer es una mejor opción para su uso con Windows Forms. En el caso de la funcionalidad del temporizador basado en servidor, es posible que considere la posibilidad de usar System.Timers.Timer, que genera eventos y tiene características adicionales.

Constructores

Timer(TimerCallback)

Inicializa una nueva instancia de la clase Timer con un período infinito y un tiempo de vencimiento infinito, utilizando el objeto Timer recién creado como objeto de estado.

Timer(TimerCallback, Object, Int32, Int32)

Inicializa una nueva instancia de la clase Timer, utilizando un entero de 32 bits con signo para especificar el intervalo de tiempo.

Timer(TimerCallback, Object, Int64, Int64)

Inicializa una nueva instancia de la clase Timer, usando enteros con signo de 64 bits para medir intervalos de tiempo.

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Inicializa una nueva instancia de la clase Timer mediante TimeSpan valores para medir intervalos de tiempo.

Timer(TimerCallback, Object, UInt32, UInt32)

Inicializa una nueva instancia de la clase Timer, usando enteros sin signo de 32 bits para medir intervalos de tiempo.

Propiedades

ActiveCount

Obtiene el número de temporizadores que están activos actualmente. Se registra un temporizador activo para marcar en algún momento del futuro y aún no se ha cancelado.

Métodos

Change(Int32, Int32)

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

Change(Int64, Int64)

Cambia la hora de inicio y el intervalo entre las invocaciones de método para un temporizador, usando enteros con signo de 64 bits para medir intervalos de tiempo.

Change(TimeSpan, TimeSpan)

Cambia la hora de inicio y el intervalo entre las invocaciones de método para un temporizador, mediante TimeSpan valores para medir los intervalos de tiempo.

Change(UInt32, UInt32)

Cambia la hora de inicio y el intervalo entre las invocaciones de método para un temporizador, usando enteros sin signo de 32 bits para medir los intervalos de tiempo.

CreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos usados por la instancia actual de Timer.

Dispose(WaitHandle)

Libera todos los recursos usados por la instancia actual de Timer y indica cuándo se ha eliminado el temporizador.

DisposeAsync()

Libera todos los recursos usados por la instancia actual de Timer.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
Finalize()

Permite a un objeto intentar liberar recursos y realizar otras operaciones de limpieza antes de que la recolección de elementos no utilizados la recupere.

GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para subprocesos.

Consulte también