C# Events (How it Works for Developers)

1. 出版商類

發布者類別是事件的來源。 它負責聲明事件，並在特定操作或條件發生時觸發該事件。 這個過程通常涉及一個事件處理方法，用於確定事件何時發生。 發布者也使用事件委託來定義可以處理該事件的方法的簽章。 例如，在圖形使用者介面 (GUI) 中，按鈕控制項會在引發"點選"事件時充當發布者。

2. 使用者類別

訂閱者類監聽事件並做出反應。 訂閱者透過將事件處理方法附加到事件上來表達其對該事件的興趣。 當發布者引發事件時，訂閱者的事件處理程序方法就會執行。 一個事件可以有多個訂閱者，當事件發生時，每個訂閱者都會做出不同的反應。

3. 代表

委託是 C# 事件的基礎。 它們是指向方法的型別安全指針，並定義了所有事件處理程序必須遵循的約定。 委託機制確保只有具有特定簽章的方法才能處理事件，從而提供一致且無錯誤的事件處理機制。

4. 事件處理程序

事件處理程序是訂閱者類別中的方法，當事件觸發時，這些方法將會被執行。 它們包含處理事件的邏輯，例如更新使用者介面、記錄資料或執行計算。 事件處理程序的簽章必須與事件關聯的委託類型相符。 此外，其他類別也可以使用事件處理程序來回應共享事件。 它使得以模組化和可重複使用的方式實現事件變得更加容易。

5. 事件數據

在許多情況下，活動需要向訂閱者傳達額外訊息。 這是透過事件資料類實現的，這些事件資料類派生自基類 EventArgs。 事件資料包含事件的具體細節，例如訊息、狀態或其他相關資訊。

步驟 1：聲明一個委託

委託定義了事件處理程序的方法簽章。 在這個例子中，我們建立了一個委託來表示事件處理程序，它有兩個參數： object sender和EventArgs e 。

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

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

步驟 2：聲明事件

事件使用event關鍵字聲明，並基於委託類型。 舉個例子：

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

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

步驟三：提出事件

該事件是透過呼叫委託並傳遞必要的參數來觸發的。

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

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

第四步：訂閱活動

訂閱者使用+=運算子註冊事件處理程序：

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

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

步驟五：處理事件

事件處理程序是訂閱者類別中與委託簽章相符的方法：

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

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

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}%");
    }
}

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 - 輸出