已更新 2026年4月23日
简化 .NET 与 Microsoft.Extensions.AI 的 LLM 集成
AI正在改变软件开发，但将大型语言模型（LLM）集成到.NET中直到现在一直很复杂。通过IronPdf.AI，将AI集成更进一步，该产品为.NET应用程序带来了OpenAI驱动的PDF解析、数据提取和内容摘要。
阅读更多
开发者更新
C# Event Handler（开发者用法）
Jacob Mellor
Updated: 2026年4月21日
在现代.NET应用程序中，事件驱动编程在提升响应速度和确保流畅用户体验方面发挥着至关重要的作用。 当像PDF生成这样的任务需要时间时，您不想阻塞主线程。 相反，您可以使用事件处理程序异步运行任务，并在事件发生时做出反应，使您的应用程序更加互动和响应灵敏。
在本指南中，我们将向您展示如何将C#事件处理方法与IronPDF集成，以在桌面和网络环境中实现无缝PDF工作流程。 无论您是使用WinForms, WPF，还是任何其他基于C#编程语言的平台，本指南都适合您。
设置您的IronPDF项目
在深入事件处理之前，让我们快速在您的.NET项目中设置IronPDF。
通过NuGet安装IronPDF
在Visual Studio的包管理器控制台中运行：
这会安装所有开始使用IronPDF生成PDF所需的东西。
使用IronPDF进行基本PDF生成
这是一个快速示例，以确保IronPDF正常工作：
using IronPdf;
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
pdf.SaveAs("example.pdf");Imports IronPdf
Private renderer = New ChromePdfRenderer()
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>")
pdf.SaveAs("example.pdf")一旦这项工作正常，您就可以准备添加事件字段，连接注册的委托，并使用委托类型创建事件驱动的工作流程。
面向.NET开发者的C#事件处理器基础
事件驱动编程基础
通过事件驱动编程，当事件发生时（例如PDF完成生成），您的应用程序会做出响应。 C#使用委托作为类型安全的函数指针，使您能够定义您的应用程序应如何响应。
您通常使用event关键字声明事件，将它们连接到事件处理方法，并使用自定义EventArgs子类传递数据。
使用event关键字声明事件
C#使用event关键字声明事件成员。 例如：
public event EventHandler PdfGenerated;Public Event PdfGenerated As EventHandler这一行声明了名为PdfGenerated的事件字段。 它使用EventHandler，这是一个内建委托，具有以下参数列表：(object sender, EventArgs e)—通常被认为是.NET中事件的命名模式。
在C#中定义和订阅事件
使用委托向事件添加方法
C# 事件支持在运行时使用 += 语法动态 添加方法。 具体方法如下
pdfService.PdfGenerated += (s, e) =>
{
Console.WriteLine("PDF was generated!");
};AddHandler pdfService.PdfGenerated, Sub(s, e)
Console.WriteLine("PDF was generated!")
End Sub这个订阅者类监听PdfGenerated事件，并在触发时执行方法调用。
自定义事件数据
要传递事件数据（例如生成的文件路径），请从EventArgs定义一个派生类：
public class PdfGeneratedEventArgs : EventArgs
{
public string FilePath { get; set; } // returned value
}Public Class PdfGeneratedEventArgs
Inherits EventArgs
Public Property FilePath() As String ' - returned value
End Class然后使用通用委托类型重新定义事件：
public event EventHandler<PdfGeneratedEventArgs> PdfGenerated;Public Event PdfGenerated As EventHandler(Of PdfGeneratedEventArgs)当事件被引发时，这为您提供了结构化的、类型安全的数据，使您的响应逻辑更强大。
处理多个事件
您可以定义多个事件：
public event EventHandler PdfGenerationStarted;
public event EventHandler<PdfGeneratedEventArgs> PdfGenerationCompleted;Public Event PdfGenerationStarted As EventHandler
Public Event PdfGenerationCompleted As EventHandler(Of PdfGeneratedEventArgs)每个事件字段由一个订阅者类处理，允许每个阶段具有不同的事件处理方法。 这种关注点分离在复杂的工作流程中是有意义的。
结合IronPDF使用事件处理器
在生成大型PDF时，在后台线程上运行IronPDF并在完成时通知UI是有意义的。 以下是事件驱动设计如何提供帮助：
- 使用BackgroundWorker异步生成PDF
- 在每个阶段完成时引发事件
- 使用event data对象传递结果数据
代码示例 – 异步生成PDF
以下示例是使用IronPDF进行事件处理的完整代码：
using System;
using System.ComponentModel;
using IronPdf;
namespace IronPdfEventHandlerExample
{
// 1. Define custom EventArgs to carry event data
public class PdfGeneratedEventArgs : EventArgs
{
public string FilePath { get; set; }
}
// 2. Main class with event, BackgroundWorker, and logic
public class PdfGenerator
{
// Declare the public event using EventHandler<t>
public event EventHandler<PdfGeneratedEventArgs> PdfGenerated;
private readonly BackgroundWorker _worker;
public PdfGenerator()
{
_worker = new BackgroundWorker();
_worker.DoWork += OnDoWork;
_worker.RunWorkerCompleted += OnRunWorkerCompleted;
}
// Start the async operation
public void GenerateAsync(string html, string outputPath)
{
_worker.RunWorkerAsync(new Tuple<string, string>(html, outputPath));
}
// Perform PDF generation in background
private void OnDoWork(object sender, DoWorkEventArgs e)
{
var (html, path) = (Tuple<string, string>)e.Argument;
var renderer = new HtmlToPdf();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);
e.Result = path;
}
// Notify subscribers when the PDF is ready
private void OnRunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
var path = e.Result as string;
PdfGenerated?.Invoke(this, new PdfGeneratedEventArgs { FilePath = path });
}
}
// 3. Program to wire it all together
class Program
{
public static void Main(string[] args)
{
var generator = new PdfGenerator();
// Subscribe to the PdfGenerated event
generator.PdfGenerated += OnPdfGenerated;
Console.WriteLine("Generating PDF asynchronously...");
generator.GenerateAsync("<h1>Hello, IronPDF!</h1>", "output.pdf");
Console.WriteLine("Press any key to exit after generation.");
Console.ReadKey();
}
// Event handler for when the PDF is ready
static void OnPdfGenerated(object sender, PdfGeneratedEventArgs e)
{
Console.WriteLine($"PDF generated at: {e.FilePath}");
}
}
}Imports System
Imports System.ComponentModel
Imports IronPdf
Namespace IronPdfEventHandlerExample
' 1. Define custom EventArgs to carry event data
Public Class PdfGeneratedEventArgs
Inherits EventArgs
Public Property FilePath As String
End Class
' 2. Main class with event, BackgroundWorker, and logic
Public Class PdfGenerator
' Declare the public event using EventHandler(Of T)
Public Event PdfGenerated As EventHandler(Of PdfGeneratedEventArgs)
Private ReadOnly _worker As BackgroundWorker
Public Sub New()
_worker = New BackgroundWorker()
AddHandler _worker.DoWork, AddressOf OnDoWork
AddHandler _worker.RunWorkerCompleted, AddressOf OnRunWorkerCompleted
End Sub
' Start the async operation
Public Sub GenerateAsync(html As String, outputPath As String)
_worker.RunWorkerAsync(Tuple.Create(html, outputPath))
End Sub
' Perform PDF generation in background
Private Sub OnDoWork(sender As Object, e As DoWorkEventArgs)
Dim args = DirectCast(e.Argument, Tuple(Of String, String))
Dim html = args.Item1
Dim path = args.Item2
Dim renderer = New HtmlToPdf()
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs(path)
e.Result = path
End Sub
' Notify subscribers when the PDF is ready
Private Sub OnRunWorkerCompleted(sender As Object, e As RunWorkerCompletedEventArgs)
Dim path = TryCast(e.Result, String)
RaiseEvent PdfGenerated(Me, New PdfGeneratedEventArgs With {.FilePath = path})
End Sub
End Class
' 3. Program to wire it all together
Module Program
Sub Main(args As String())
Dim generator = New PdfGenerator()
' Subscribe to the PdfGenerated event
AddHandler generator.PdfGenerated, AddressOf OnPdfGenerated
Console.WriteLine("Generating PDF asynchronously...")
generator.GenerateAsync("<h1>Hello, IronPDF!</h1>", "output.pdf")
Console.WriteLine("Press any key to exit after generation.")
Console.ReadKey()
End Sub
' Event handler for when the PDF is ready
Private Sub OnPdfGenerated(sender As Object, e As PdfGeneratedEventArgs)
Console.WriteLine($"PDF generated at: {e.FilePath}")
End Sub
End Module
End Namespace控制台输出
PDF 输出
此代码中的关键特性
public event EventHandler<PdfGeneratedEventArgs>：声明一个强类型的事件PdfGeneratedEventArgs：事件数据的自定义类BackgroundWorker：允许异步执行以避免UI阻塞?.Invoke(...)：安全的事件调用Tuple<string, string>：将HTML和输出路径传递到后台线程
在.NET中使用事件的技巧
1. 避免UI线程阻塞
使用事件处理程序如RunWorkerCompleted，在后台任务完成后执行UI更新。
2. 优雅地处理异常
在DoWork中将您的工作逻辑包装在try-catch块中，并通过e.Error将异常传递给RunWorkerCompleted。
if (e.Error != null)
{
MessageBox.Show("Error: " + e.Error.Message);
}If e.Error IsNot Nothing Then
MessageBox.Show("Error: " & e.Error.Message)
End If3. 在必要时取消订阅
在长期运行的应用程序中，当不再需要时取消订阅事件，以避免内存泄漏：
pdfWorker.DoWork -= PdfWorker_DoWork;pdfWorker.DoWork -= PdfWorker_DoWork最后的想法
使用事件处理器、委托类型和事件字段与IronPDF，使.NET应用程序具备响应性和现代化优势。 无论您是在基类中生成文档，还是在派生类中创建可重用逻辑，或者只是探索.NET的事件模型，此模式都是可扩展和干净的。
何时使用这种方法
- 您想在任务完成时引发一个事件
- 您需要在逻辑和UI之间有明确的分离
- 您正在使用**
BackgroundWorker**，事件和委托 - 您偏爱C#的类型安全函数指针机制
替代方案以探索
Task.Run用于新的工作流程IProgress<t>在长时间操作期间进行实时更新，IronPDF结合C#事件使创建强大、响应式的PDF生成应用程序变得简单，考虑到实际可用性。 准备好在您的.NET应用程序中实施事件驱动的PDF生成吗？ 使用IronPDF免费试用版尝试一下，通过流畅、无阻塞的体验让您的用户满意！
首席技术官
Jacob Mellor 是 Iron Software 的首席技术官，也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者，他从公司成立之初就开始塑造公司的产品架构，与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司，为 NASA、特斯拉和全球政府机构提供服务。
相关文章
当您需要PDF看起来像HTML时，速度快。
