.NET 幫助

C# 計時器（開發人員如何使用）

發佈 2024年3月6日

介紹

在C#中，計時器類是用於在指定間隔調度執行代碼的強大工具。無論您是在開發 Windows Form 應用程式還是控制台應用程式，了解如何使用計時器可以大幅提升您的應用程式功能。本教程將引導您了解在 C# 中使用計時器的基本知識，包括如何設置計時器、處理其事件，以及確保它們在應用程式中順利運行。我們還將討論如何使用IronPDF 用於在 C# 應用程式中自動生成 PDF用計時器在 C# 中自動化我們的 PDF 生成。

C# 計時器類別介紹

C# 計時器（對開發人員的運作方式）：圖 1 - Timer 類別

C# 提供了多種定時器類，每種都適合不同的任務和環境。最常用的計時器類別是伺服器端計時器的 System.Timers.Timer 和適用於 Windows Forms 應用的 System.Windows.Forms.Timer。瞭解事件處理程式的角色在使用計時器類別時至關重要，因為這些處理程式決定了計時器所指示的每個重要時刻所執行的操作，例如滴答聲或經過時間間隔的事件。

設定新計時器

配置計時器的時間間隔是其運行的基礎，決定計時器的事件處理程序被調用的頻率，從而控制應用程式時間敏感功能的節奏。在您的 C# 應用程式中使用計時器時，特別是在開發 Windows Forms 應用程式時，可以從工具箱中將 System.Windows.Forms.Timer 元件添加到您的表單上，或通過程式碼創建計時器物件以獲得更多的靈活性。

var timer = new System.Timers.Timer(); // use a timer
timer.Interval = 2000; // Sets the timer interval to tick every 2 seconds

var timer = new System.Timers.Timer(); // use a timer
timer.Interval = 2000; // Sets the timer interval to tick every 2 seconds

Dim timer = New System.Timers.Timer() ' use a timer
timer.Interval = 2000 ' Sets the timer interval to tick every 2 seconds

VB C#

此簡單設置創建一個每兩秒滴答一次的計時器。但是，要讓計時器執行動作，您需要將其連接到事件處理程序。

處理 Elapsed 事件

通過將經過事件處理程序附加到 System.Timers.Timer 的 Elapsed 事件，您可以確保應用程式可以在每個時間間隔執行任務，有效回應基於時間的觸發器。每當計時器的間隔時間過去時，這個事件就會被觸發。您可以將處理程序附加到此事件，以指定計時器滴答時應發生的情況：

timer.Elapsed += OnTimedEvent;

timer.Elapsed += OnTimedEvent;

timer.Elapsed += OnTimedEvent

VB C#

在上述程式碼中，OnTimedEvent 是您定義的一個方法，每當計時器的 Elapsed 事件被觸發時，這個方法將被調用。

建立事件處理程式

在定義計時器事件處理器時，您設計一個方法以響應計時器的滴答事件執行，從而可以精確控制在預定間隔採取的行動。計時器的Elapsed事件的事件處理程式通常如下所示：

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

VB C#

此方法僅在計時器逾時時將當前時間列印到控制台，展示如何響應計時器事件。

啟動和停止計時器

在設定好計時器及其事件處理程序後，您需要啟動計時器。您可以透過將其 Enabled 屬性設置為 true 或呼叫 Start 方法來執行此操作：

timer.Enabled = true; // or timer.Start();

timer.Enabled = true; // or timer.Start();

timer.Enabled = True ' or timer.Start();

VB C#

要停止計時器，您可以將 Enabled 設為 false 或調用 Stop 方法。這對於防止您的應用程序在不需要時運行不必要的操作至關重要。

在 Windows Forms 應用程式中使用計時器

System.Windows.Forms.Timer 是一個有價值的 Windows 表單元件，旨在無縫整合至 Windows Forms 應用程式的事件驅動模型中，便利地執行定期動作而不影響使用者介面的回應性。

範例：將計時器添加到表單

在 Windows Forms 應用程式中，您可以從工具箱中拖曳計時器控制項到您的表單上，或者以程式方式創建，如下所示：

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

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

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

VB C#

在這裡，TimerEventProcessor 是一個事件處理器，每次 Tick 事件發生時都會被調用，這類似於 System.Timers.Timer 中的 Elapsed 事件。

高級計時管理

計時器的執行緒安全性

在使用計時器時，了解應用程式的線程模型至關重要。 System.Timers.Timer 和 System.Threading.Timer 在執行回呼時使用了線程池中的線程，允許並行執行。然而，如果您的回調方法修改了共享數據或與用戶界面元素交互，這可能會導致線程安全問題。要從計時器的回呼中安全更新 UI 元素，必須使用特定於應用程式類型的技術將回呼調度回 UI 執行緒。(例如，使用 Invoke 或 BeginInvoke 在 Windows Forms 中).

高精度計時

對於需要高精度計時的應用程式(例如，多媒體應用程式或遊戲)，System.Diagnostics.Stopwatch 類別比計時器更適合用於測量高精度的經過時間。儘管本身不是計時器，Stopwatch 類可以與計時器一起使用，以達到精確的時間測量。

實用範例

範例：實現倒數計時器

一個計時器有用的常見情境是創建倒數計時器。這可以透過將計時器間隔設為一秒來完成(1000 毫秒)並在每次計時器結束時減少計數器。當計數器歸零時，計時器會停止，表示倒數結束。

using System;
namespace CountdownApp
{
    class Program
    {
        static int countdownTime = 10; // Countdown from 10 seconds
// public static void main
        public static void Main(string [] args)
        {
            StartCountdown();
            Console.ReadLine(); // Prevent console from closing immediately
        }
        static void StartCountdown()
        {
            var timer = new System.Timers.Timer(1000); // Tick every second, var timer
            timer.Elapsed += UpdateCountdown;
            timer.Enabled = true;
        }
// public static void printtimes
        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
        public static void Main(string [] args)
        {
            StartCountdown();
            Console.ReadLine(); // Prevent console from closing immediately
        }
        static void StartCountdown()
        {
            var timer = new System.Timers.Timer(1000); // Tick every second, var timer
            timer.Elapsed += UpdateCountdown;
            timer.Enabled = true;
        }
// public static void printtimes
        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 static void main
		Public Shared Sub Main(ByVal args() As String)
			StartCountdown()
			Console.ReadLine() ' Prevent console from closing immediately
		End Sub
		Private Shared Sub StartCountdown()
			Dim timer = New System.Timers.Timer(1000) ' Tick every second, var timer
			AddHandler timer.Elapsed, AddressOf UpdateCountdown
			timer.Enabled = True
		End Sub
' public static void printtimes
		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

VB C#

以下是上述程式碼的輸出：

C# 計時器（開發人員如何使用）：圖 2 - 倒數計時器輸出

範例：安排定期資料庫檢查

定時器可以用來定期檢查資料庫，例如查詢新資料或清理舊記錄。此示例設置了一個計時器，每小時查詢一次資料庫：

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

VB C#

IronPDF 介紹

IronPDF - 輕鬆從 HTML 和 ASPX 生成 PDF特別受到讚賞的是其從 HTML 或 URL 生成 PDF 的易用性，基本上允許您的應用程式“打印”任何將 HTML 內容轉換為 PDF 文件. 這對於生成報告、發票或任何需要以標準化格式呈現的網頁內容非常有用。 IronPDF還支持高級功能，例如CSS樣式、JavaScript和自定義字體，確保生成的PDF保持網頁內容的忠實度。

IronPDF 的一個顯著特點是其HTML 轉 PDF功能，保留佈局和樣式。它從網路內容生成 PDF，這對於報告、發票和文件是理想的。 HTML 文件、URL 和 HTML 字串可以輕鬆轉換為 PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

VB C#

安裝 IronPDF

您可以通過執行以下命令，使用 NuGet 封裝管理器安裝 IronPDF：

Install-Package IronPdf

範例

假設您需要生成每日更新資料的 PDF 格式報告。為了簡化，我們將生成一個基本的 HTML 報告，並使用 IronPDF 每24小時將其轉換為 PDF。在您的 C# 應用程式中，您會設置一個 System.Timers.Timer 以每 24 小時觸發一次。值得注意的是，這個間隔是以毫秒為單位設定的，因此 24 小時表示為 24 * 60 * 60 * 1000 毫秒。

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

VB C#