IRONSOFTWAREHOME
開發者更新

C# 事件 (如何為開發人員運作)

Jacob Mellor, Chief Technology Officer @ Team Iron
Jacob Mellor
Updated: 2026年4月23日

C#中的事件是事件驅動程式設計的基本部分。 它們允許物件在發生值得注意的事情時進行溝通及通知其他物件。 在本指南中,我們將探討事件,以及如何宣告和使用它們。 讓我們一步一步地分解它,以確保明確理解。 我們還將探索IronPDF在C#應用程式中的PDF操作。

什麼是C#中的事件?

C#中的事件實現了物件之間的通信。 當事件發生時,其他物件可以對它做出響應。 事件依賴委派,它作為到方法的型別安全指標。 事件委派型別定義可以處理公共事件的方法簽名,確保事件資料處理的一致性。

事件的核心組成部分

為了充分了解事件,我們來看一下它們的主要組成部分:

1. 發布者類

發布者類是事件的來源。 它負責宣告事件,並在特定動作或條件發生時觸發它。 此過程通常包括一個事件處理方法來確定事件的發生時間。 發布者還使用事件委派來定義可以處理該事件的方法的簽名。 例如,在圖形使用者介面 (GUI) 中,按鈕控制元件在觸發"點擊"事件時充當發布者。

2. 訂閱者類

訂閱者類監聽事件並對其作出反應。 訂閱者通過將事件處理方法附加到事件來註冊對事件的興趣。 當發布者觸發事件時,訂閱者的事件處理方法將執行。 單個事件可以有多個訂閱者,每個訂閱者在事件發生時都會以不同的方式響應。

3. 委派

委派是C#中事件的基礎。 它們是對方法的型別安全指標,並定義所有事件處理程式必須遵循的協定。 委派確保只有具有特定簽名的方法才能處理該事件,提供一致且無錯誤的事件處理機制。

4. 事件處理程式

事件處理程式是訂閱者類中的方法,在觸發事件時被執行。 它們包含處理事件的邏輯,如更新UI、記錄資料或進行計算。 事件處理程式的簽名必須與與事件關聯的委派型別匹配。 此外,其他類別也可以使用事件處理程式來響應共享事件。 這使得以模塊化和可重用的方式實現事件變得更加容易。

5. 事件資料

在許多情況下,事件需要向訂閱者傳達額外的資訊。 這是使用事件資料類實現的,該類是從基礎 EventArgs 類派生的。 事件資料包含有關事件的具體細節,如訊息、狀態或其他相關資訊。

How to Declare and Use Events in C#

步驟1:宣告委派

委派定義事件處理程式的方法簽名。 在此範例中,我們建立了一個委派來表示具有兩個參數的事件處理程式:EventArgs e

public delegate void MyEventHandler(object sender, EventArgs e);

步驟2:宣告事件

事件使用event關鍵字聲明,並基於委派型別。 這裡有一個範例:

public class Publisher
{
    public event MyEventHandler Notify; // Declare the event.
}

步驟3:觸發事件

事件是通過調用委派並傳遞必要的參數來觸發的。

public void TriggerEvent()
{
    if (Notify != null) // Check if there are subscribers.
    {
        Notify(this, EventArgs.Empty); // Raise the event.
    }
}

步驟4:訂閱事件

訂閱者使用+=運算符註冊事件處理程式:

Publisher publisher = new Publisher();
Subscriber subscriber = new Subscriber();
publisher.Notify += subscriber.OnNotify; // Subscribe to the event.

步驟5:處理事件

事件處理器是訂閱者類中的一個方法,與委派的簽名匹配:

public void OnNotify(object sender, EventArgs e)
{
    Console.WriteLine("Event received!");
}

IronPDF:C# PDF程式庫

IronPDF是一個用於.NET生成PDF的多功能程式庫,可以無縫整合到C#應用程式中。 結合C#中的事件,它可以提供一種動態方式來處理實時情景,如進度更新、錯誤處理或在PDF生成或操作期間的通知。 讓我們引人入勝地探索這種關係。 在C#中,事件是一種表示有事情發生的方式。 它們允許您的程式的一部分通知其他部分關於特定事件的發生,如文件被處理、任務完成或遇到錯誤。

IronPDF如何適應?

IronPDF允許您生成、修改和保護PDF,將其與事件整合可以使您的應用程式更加互動。例如:

  • **進度跟蹤:**在生成大型PDF報告時,通知訂戶完成百分比。
  • **錯誤處理:**如果在PDF渲染或保存期間出現問題,觸發一個事件。
  • **自訂操作:**在特定的PDF操作後執行自訂邏輯,例如記錄或UI更新。

範例:生成具有事件通知的PDF

這裡有一個簡單的例子,展示如何使用IronPDF與事件:

using IronPdf;
using System;

// Program class
class Program
{
    // Define a custom event for progress updates
    public static event Action<int> ProgressUpdated;

    public static void Main()
    {
        License.LicenseKey = "License-Key";
        // Subscribe to the ProgressUpdated event
        ProgressUpdated += DisplayProgress;
        
        Console.WriteLine("Generating PDF...");
        GeneratePdf(); // Generate the PDF
    }

    // Method to generate PDF and trigger progress updates
    static void GeneratePdf()
    {
        try
        {
            var Renderer = new ChromePdfRenderer();
            for (int i = 0; i <= 100; i += 20)
            {
                // Simulate progress
                System.Threading.Thread.Sleep(500);
                ProgressUpdated?.Invoke(i); // Trigger event with progress value
            }
            // Generate a PDF
            var PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF with Events!</h1>");
            PdfDocument.SaveAs("IronPDF/example.pdf");
            ProgressUpdated?.Invoke(100); // Final update
            Console.WriteLine("PDF generated successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    // Event handler to display progress
    static void DisplayProgress(int progress)
    {
        Console.WriteLine($"Progress: {progress}%");
    }
}

C#事件(對開發者的工作原理):圖1 - 輸出

結論

C#事件(對開發者的工作原理):圖2 - 授權

C#中的事件與IronPDF結合時,形成了一個強大的系統,用於動態PDF生成和管理。 事件提供了一種乾淨、高效的方法來異步處理PDF操作,而IronPDF則提供了跨.NET平台的PDF建立、編輯和操作的強大功能。 IronPDF提供免費試用,以測試所有功能而無限制。 商業授權起價$999,提供對完整的PDF生成和處理能力套件的存取。

Jacob Mellor, Chief Technology Officer @ Team Iron
Chief Technology Officer

Jacob Mellor is Chief Technology Officer at Iron Software and a visionary engineer pioneering C# PDF technology. As the original developer behind Iron Software's core codebase, he has shaped the company's product architecture since its inception, transforming it alongside CEO Cameron Rimington into a 50+ person company serving NASA, Tesla, and global government agencies.

...
Read More

Related Articles

Key in blue circle

立即免費取得 30 天試用金鑰

bullet_checked無需信用卡或建立帳號
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge related to IronPDF Product Demo

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰
無需信用卡或帳戶建立