C# Timer (Cómo Funciona para Desarrolladores)

Creación de un controlador de eventos

Al definir un manejador de eventos de temporizador, elaboras un método que se ejecuta en respuesta a los eventos de marca del temporizador, permitiendo un control preciso sobre las acciones tomadas en intervalos predefinidos. Un manejador de eventos para el evento Elapsed de un temporizador típicamente se ve así:

static void OnTimedEvent(Object source, System.Timers.ElapsedEventArgs e)
{
    Console.WriteLine("The Elapsed event was raised at {0:HH:mm:ss.fff}", e.SignalTime);
}

static void OnTimedEvent(Object source, System.Timers.ElapsedEventArgs e)
{
    Console.WriteLine("The Elapsed event was raised at {0:HH:mm:ss.fff}", e.SignalTime);
}

Shared Sub OnTimedEvent(ByVal source As Object, ByVal e As System.Timers.ElapsedEventArgs)
	Console.WriteLine("The Elapsed event was raised at {0:HH:mm:ss.fff}", e.SignalTime)
End Sub

Este método simplemente imprime la hora actual en la consola cada vez que transcurre el temporizador, demostrando cómo responder al evento del temporizador.

Ejemplo: Cómo añadir un temporizador a un formulario

En una aplicación Windows Forms, puede arrastrar un control de temporizador desde la caja de herramientas a su formulario, o crearlo programáticamente de la siguiente manera:

System.Windows.Forms.Timer myTimer = new System.Windows.Forms.Timer();
myTimer.Interval = 1000; // 1 second interval
myTimer.Tick += new EventHandler(TimerEventProcessor);
myTimer.Start();

System.Windows.Forms.Timer myTimer = new System.Windows.Forms.Timer();
myTimer.Interval = 1000; // 1 second interval
myTimer.Tick += new EventHandler(TimerEventProcessor);
myTimer.Start();

Dim myTimer As New System.Windows.Forms.Timer()
myTimer.Interval = 1000 ' 1 second interval
AddHandler myTimer.Tick, AddressOf TimerEventProcessor
myTimer.Start()

Aquí, TimerEventProcessor es un manejador de eventos que se llamará cada vez que ocurra el evento Tick, que es similar al evento Elapsed en System.Timers.Timer.

Seguridad de hilos con temporizadores

Al trabajar con temporizadores, es crucial comprender el modelo de subprocesos de su aplicación. El System.Timers.Timer y System.Threading.Timer ejecutan sus callbacks en un hilo del grupo de subprocesos, permitiendo la ejecución en paralelo. Sin embargo, esto puede llevar a problemas de seguridad de hilos si su método callback modifica datos compartidos o interactúa con elementos de la interfaz de usuario. Para actualizar de manera segura los elementos de la interfaz de usuario desde la devolución de llamada de un temporizador, debe trasladar la llamada de regreso al hilo de la interfaz de usuario usando técnicas específicas para el tipo de su aplicación (por ejemplo, usando Invoke o BeginInvoke en Windows Forms).

Temporización de alta precisión

Para aplicaciones que requieren temporización de alta precisión (por ejemplo, aplicaciones multimedia o juegos), la clase System.Diagnostics.Stopwatch puede ser más apropiada que un temporizador para medir tiempos transcurridos con alta precisión. Aunque no es un temporizador en sí, la clase Stopwatch puede usarse en conjunto con un temporizador para lograr mediciones de tiempo precisas.

Ejemplo: Implementación de un temporizador de cuenta atrás

Un escenario común donde un temporizador es útil es la creación de un temporizador de cuenta regresiva. Esto se puede hacer configurando un intervalo de temporizador a un segundo (1000 milisegundos) y disminuyendo un contador cada vez que transcurre el temporizador. Cuando el contador alcanza cero, el temporizador se detiene, señalando el final de la cuenta regresiva.

using System;

namespace CountdownApp
{
    class Program
    {
        static int countdownTime = 10; // Countdown from 10 seconds

        public static void Main(string[] args) // Main method
        {
            StartCountdown();
            Console.ReadLine(); // Prevent console from closing immediately
        }

        static void StartCountdown()
        {
            var timer = new System.Timers.Timer(1000); // Tick every second
            timer.Elapsed += UpdateCountdown;
            timer.Enabled = true;
        }

        static void UpdateCountdown(Object source, System.Timers.ElapsedEventArgs e)
        {
            if (countdownTime > 0)
            {
                Console.WriteLine(countdownTime-- + " seconds remaining");
            }
            else
            {
                Console.WriteLine("Countdown finished!");
                ((System.Timers.Timer)source).Stop(); // Stop the timer
            }
        }
    }
}

using System;

namespace CountdownApp
{
    class Program
    {
        static int countdownTime = 10; // Countdown from 10 seconds

        public static void Main(string[] args) // Main method
        {
            StartCountdown();
            Console.ReadLine(); // Prevent console from closing immediately
        }

        static void StartCountdown()
        {
            var timer = new System.Timers.Timer(1000); // Tick every second
            timer.Elapsed += UpdateCountdown;
            timer.Enabled = true;
        }

        static void UpdateCountdown(Object source, System.Timers.ElapsedEventArgs e)
        {
            if (countdownTime > 0)
            {
                Console.WriteLine(countdownTime-- + " seconds remaining");
            }
            else
            {
                Console.WriteLine("Countdown finished!");
                ((System.Timers.Timer)source).Stop(); // Stop the timer
            }
        }
    }
}

Imports System

Namespace CountdownApp
	Friend Class Program
		Private Shared countdownTime As Integer = 10 ' Countdown from 10 seconds

		Public Shared Sub Main(ByVal args() As String) ' Main method
			StartCountdown()
			Console.ReadLine() ' Prevent console from closing immediately
		End Sub

		Private Shared Sub StartCountdown()
			Dim timer = New System.Timers.Timer(1000) ' Tick every second
			AddHandler timer.Elapsed, AddressOf UpdateCountdown
			timer.Enabled = True
		End Sub

		Private Shared Sub UpdateCountdown(ByVal source As Object, ByVal e As System.Timers.ElapsedEventArgs)
			If countdownTime > 0 Then
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: Console.WriteLine(countdownTime-- + " seconds remaining");
				Console.WriteLine(countdownTime & " seconds remaining")
				countdownTime -= 1
			Else
				Console.WriteLine("Countdown finished!")
				DirectCast(source, System.Timers.Timer).Stop() ' Stop the timer
			End If
		End Sub
	End Class
End Namespace

Aquí está la salida del código anterior:

Ejemplo: Programación de comprobaciones periódicas de bases de datos

Los temporizadores se pueden usar para realizar cheques regulares en una base de datos, como consultas para datos nuevos o limpieza de registros antiguos. Este ejemplo configura un temporizador para consultar una base de datos cada hora:

private static void SetupDatabaseCheckTimer()
{
    var timer = new System.Timers.Timer(3600000); // Set to 1 hour
    timer.Elapsed += CheckDatabase;
    timer.Enabled = true;
}

private static void CheckDatabase(Object source, System.Timers.ElapsedEventArgs e)
{
    // Perform database operations here
    Console.WriteLine("Database checked at " + e.SignalTime);
}

private static void SetupDatabaseCheckTimer()
{
    var timer = new System.Timers.Timer(3600000); // Set to 1 hour
    timer.Elapsed += CheckDatabase;
    timer.Enabled = true;
}

private static void CheckDatabase(Object source, System.Timers.ElapsedEventArgs e)
{
    // Perform database operations here
    Console.WriteLine("Database checked at " + e.SignalTime);
}

Private Shared Sub SetupDatabaseCheckTimer()
	Dim timer = New System.Timers.Timer(3600000) ' Set to 1 hour
	AddHandler timer.Elapsed, AddressOf CheckDatabase
	timer.Enabled = True
End Sub

Private Shared Sub CheckDatabase(ByVal source As Object, ByVal e As System.Timers.ElapsedEventArgs)
	' Perform database operations here
	Console.WriteLine("Database checked at " & e.SignalTime)
End Sub

Instalación de IronPDF

Puede instalar IronPDF usando el Administrador de Paquetes NuGet ejecutando este comando:

Install-Package IronPdf

Ejemplo

Imagina que tienes un requerimiento para generar un reporte diario en formato PDF, conteniendo datos que se actualizan cada día. Para simplicidad, generaremos un reporte HTML básico y lo convertiremos en PDF usando IronPDF cada 24 horas. En su aplicación C#, configurará un System.Timers.Timer para activarse cada 24 horas. Es importante tener en cuenta que el intervalo se establece en milisegundos, por lo que 24 horas se representan como 24 * 60 * 60 * 1000 milisegundos.

using System;
using System.Timers;
using IronPdf;
using Timer = System.Timers.Timer;

class Program
{
    static void Main(string[] args)
    {
        // Set up the timer for 24 hours
        Timer timer = new Timer(24 * 60 * 60 * 1000);
        timer.Elapsed += OnTimedEvent;
        timer.AutoReset = true;
        timer.Enabled = true;

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

    private static void OnTimedEvent(Object source, ElapsedEventArgs e)
    {
        GeneratePdfReport();
    }

    private static void GeneratePdfReport()
    {
        var renderer = new HtmlToPdf();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Daily Report</h1><p>This is the automated daily report.</p>");
        string outputPath = $"f:\\DailyReport_{DateTime.Now:yyyyMMdd}.pdf";
        pdf.SaveAs(outputPath);
        Console.WriteLine($"Generated PDF report at {outputPath}");
    }
}

using System;
using System.Timers;
using IronPdf;
using Timer = System.Timers.Timer;

class Program
{
    static void Main(string[] args)
    {
        // Set up the timer for 24 hours
        Timer timer = new Timer(24 * 60 * 60 * 1000);
        timer.Elapsed += OnTimedEvent;
        timer.AutoReset = true;
        timer.Enabled = true;

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

    private static void OnTimedEvent(Object source, ElapsedEventArgs e)
    {
        GeneratePdfReport();
    }

    private static void GeneratePdfReport()
    {
        var renderer = new HtmlToPdf();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Daily Report</h1><p>This is the automated daily report.</p>");
        string outputPath = $"f:\\DailyReport_{DateTime.Now:yyyyMMdd}.pdf";
        pdf.SaveAs(outputPath);
        Console.WriteLine($"Generated PDF report at {outputPath}");
    }
}

Imports System
Imports System.Timers
Imports IronPdf
Imports Timer = System.Timers.Timer

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set up the timer for 24 hours
		Dim timer As New Timer(24 * 60 * 60 * 1000)
		AddHandler timer.Elapsed, AddressOf OnTimedEvent
		timer.AutoReset = True
		timer.Enabled = True

		Console.WriteLine("Press Enter to exit the program.")
		Console.ReadLine()
	End Sub

	Private Shared Sub OnTimedEvent(ByVal source As Object, ByVal e As ElapsedEventArgs)
		GeneratePdfReport()
	End Sub

	Private Shared Sub GeneratePdfReport()
		Dim renderer = New HtmlToPdf()
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>Daily Report</h1><p>This is the automated daily report.</p>")
		Dim outputPath As String = $"f:\DailyReport_{DateTime.Now:yyyyMMdd}.pdf"
		pdf.SaveAs(outputPath)
		Console.WriteLine($"Generated PDF report at {outputPath}")
	End Sub
End Class

Resultado

Una vez que ejecute el código, mostrará la siguiente salida en la consola. Aquí he modificado el código para salida rápida, así que uso un temporizador de 10 segundos.

Aquí está el PDF generado: