C# 事件（开发者用法）

1. 发布者类

发布者类是事件的来源。 它负责声明事件并在特定动作或条件发生时触发事件。 这个过程通常涉及事件处理方法来确定事件何时发生。 发布者还使用事件委托来定义可以处理事件的方法的签名。 例如，在图形用户界面（GUI）中，按钮控件在触发"点击"事件时充当发布者。

2. 订阅者类

订阅者类侦听事件并对其做出反应。 订阅者通过将事件处理方法附加到事件上来注册其对事件的兴趣。 当发布者触发事件时，订阅者的事件处理方法就会执行。 单个事件可以有多个订阅者，每个订阅者在事件发生时会作出不同的反应。

3. 委托

委托是C#中事件的基础。 它们是方法的类型安全指针，并定义了所有事件处理程序必须遵循的契约。 委托确保只有具有特定签名的方法可以处理事件，提供了一致且无错误的事件处理机制。

4. 事件处理程序

事件处理程序是订阅者类中的方法，当事件被触发时执行。 它们包含处理事件的逻辑，如更新UI、记录数据或执行计算。 事件处理程序的签名必须与与事件相关联的委托类型匹配。 此外，其他类可以使用事件处理程序对共享事件作出反应。 这使得以模块化和可重用的方式实现事件变得更加容易。

5. 事件数据

在许多情况下，事件需要向订阅者传递额外的信息。 这是通过使用事件数据类来实现的，这些类派生自基类EventArgs。 事件数据包含有关事件的具体细节，如消息、状态或其他相关信息。

步骤1：声明一个委托

委托定义了事件处理程序的方法签名。 在此示例中，我们创建一个委托来表示具有两个参数的事件处理程序：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.
}

步骤3：触发事件

通过调用委托并传递必要的参数来触发事件。

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.
    }
}

步骤4：订阅事件

订阅者使用+=运算符注册事件处理程序：

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.

步骤5：处理事件

事件处理程序是订阅者类中与委托签名匹配的方法：

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