Temporizador em C# (Como funciona para desenvolvedores)

Criando um manipulador de eventos

Ao definir um manipulador de eventos de temporizador, você cria um método que é executado em resposta aos eventos de pulso do temporizador, permitindo um controle preciso sobre as ações realizadas em intervalos predefinidos. Um manipulador de eventos para o evento "Elapsed" de um temporizador normalmente se parece com isto:

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 simplesmente imprime a hora atual no console sempre que o temporizador expira, demonstrando como responder ao evento do temporizador.

Exemplo: Adicionando um cronômetro a um formulário

Em um aplicativo Windows Forms, você pode arrastar um controle de temporizador da caixa de ferramentas para o seu formulário ou criá-lo programaticamente da seguinte forma:

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()

Aqui, TimerEventProcessor é um manipulador de eventos que será chamado sempre que o evento Tick ocorrer, o que é semelhante ao evento Elapsed em System.Timers.Timer .

Segurança de rosca com temporizadores

Ao trabalhar com temporizadores, é crucial entender o modelo de threading da sua aplicação. As classes System.Timers.Timer e System.Threading.Timer executam seus callbacks em uma thread do pool de threads, permitindo a execução paralela. No entanto, isso pode levar a problemas de segurança de threads se o seu método de retorno de chamada modificar dados compartilhados ou interagir com elementos da interface do usuário. Para atualizar com segurança os elementos da interface do usuário a partir do retorno de chamada de um temporizador, você deve encaminhar a chamada de retorno para a thread da interface do usuário usando técnicas específicas para o tipo do seu aplicativo (por exemplo, usando Invoke ou BeginInvoke no Windows Forms).

Temporização de Alta Precisão

Para aplicações que exigem temporização de alta precisão (por exemplo, aplicações multimídia ou jogos), a classe System.Diagnostics.Stopwatch pode ser mais apropriada do que um temporizador para medir o tempo decorrido com alta exatidão. Embora não seja um temporizador em si, a classe Stopwatch pode ser usada em conjunto com um temporizador para obter medições de tempo precisas.

Exemplo: Implementando um temporizador de contagem regressiva

Um cenário comum em que um temporizador é útil é na criação de um cronômetro regressivo. Isso pode ser feito definindo um intervalo de temporizador para um segundo (1000 milissegundos) e decrementando um contador cada vez que o temporizador expirar. Quando o contador chega a zero, o cronômetro para, sinalizando o fim da contagem regressiva.

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

Aqui está o resultado do código acima:

Exemplo: Agendamento de verificações regulares do banco de dados

Os temporizadores podem ser usados ​​para realizar verificações regulares em um banco de dados, como consultar novos dados ou limpar registros antigos. Este exemplo configura um temporizador para consultar um banco de dados a 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

Instalando o IronPDF

Você pode instalar o IronPDF usando o Gerenciador de Pacotes NuGet executando este comando:

Install-Package IronPdf

Exemplo

Imagine que você precisa gerar um relatório diário em formato PDF, contendo dados que são atualizados diariamente. Para simplificar, vamos gerar um relatório HTML básico e convertê-lo para PDF usando o IronPDF a cada 24 horas. Em sua aplicação C#, você configurará um System.Timers.Timer para ser acionado a cada 24 horas. É importante notar que o intervalo é definido em milissegundos, portanto, 24 horas são representadas como 24 * 60 * 60 * 1000 milissegundos.

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

Saída

Após executar o código, a seguinte saída será exibida no console. Aqui, modifiquei o código para obter uma saída mais rápida, utilizando um temporizador de 10 segundos.

Aqui está o PDF gerado: