1. IronPDF
  2. 操作指南
  3. 保存与导出 PDF 文档
如何在 C# 中导出 PDF | IronPDF

C#导出到 PDF 代码示例教程

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

使用 IronPdf 在 C# 中使用 SaveAs(), Stream 和 BinaryData 等简单方法将 HTML 内容导出为 PDF。 该 C# PDF 库使开发人员能够以编程方式将 HTML 转换为 PDF 文档，并将其提供给网络浏览器或保存到磁盘。

IronPDF 是一个C# PDF 库，允许您使用 C# 将 HTML 保存为 PDF。 它还允许 C# / VB 开发人员以编程方式编辑 PDF 文档。 无论您是生成报告、创建发票还是转换网页，IronPDF 都能为 C# 应用程序中的 PDF 生成提供强大的解决方案。

标题:2(快速入门：使用 IronPDF 将 HTML 导出为 C# 中的 PDF)

使用 IronPDF 用 C# 将 HTML 内容导出为 PDF。 本指南向您展示了如何将 HTML 转换为 PDF 文档并保存，只需几行代码即可完成。 IronPDF 简化了 PDF 生成过程，允许开发人员将 PDF 导出功能集成到他们的应用程序中。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件：

  1. 使用 NuGet 包管理器安装 IronPDF

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>HelloPDF</h1>").SaveAs("myExportedFile.pdf");

  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronPDF，免费试用！
    arrow pointer

最小工作流程（5 个步骤）

  1. 从 NuGet 安装 C# PDF 导出库。
  2. 探索数字签名方法的 PdfDocument 文档
  3. 使用 System.IO.MemoryStream 将 PDF 保存到内存中
  4. 将 PDF 以二进制数据而非 HTML 的形式提供给网络
  5. 将 PDF 导出为文件


保存 PDF 的不同选项有哪些？ --> <！--说明：显示代码执行输出或结果的截图 --> 在使用 C# 处理 PDF 文档时，IronPDF 提供了多种保存和导出生成 PDF 的选项。 从简单的文件存储到在网络应用程序中提供 PDF 服务，每种方法都有不同的用例。 以下各节将介绍在 C# 中导出和保存 PDF 的可用选项。 ### 如何将 PDF 保存到磁盘 使用[`PdfDocument.SaveAs`](/object-reference/api/IronPdf.PdfDocument.html)方法将 PDF 保存到磁盘。 对于桌面应用程序或需要在服务器上永久存储 PDF 时，这是最直接的方法。 ```csharp // Complete example for saving PDF to disk using IronPdf; // Initialize the Chrome PDF renderer var renderer = new ChromePdfRenderer(); // Create HTML content with styling string htmlContent = @"

Date: " + DateTime.Now.ToString("yyyy-MM-dd") + @"

Thank you for your business!

"; // Render HTML to PDF PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); // Save to disk with standard method pdf.SaveAs("invoice_12345.pdf"); // Save with password protection for sensitive documents pdf.Password = "secure123"; pdf.SaveAs("protected_invoice_12345.pdf"); ``` 此方法支持添加密码保护。 查看以下文章，了解更多有关对导出的 PDF 进行数字签名的信息：[ 对 PDF 文档进行数字签名](https://ironpdf.com/how-to/signing/)。有关其他安全选项，请浏览我们的[PDF权限和密码](https://ironpdf.com/how-to/pdf-permissions-passwords/)指南。 ### 如何在 C## (`System.IO.MemoryStream`) 中将 PDF 文件保存到 MemoryStream 中。 [`IronPdf.PdfDocument.Stream`](/object-reference/api/IronPdf.PdfDocument.html)属性使用`System.IO.MemoryStream`将 PDF 保存到内存。 当您需要在内存中操作 PDF 数据或将其传递给其他方法而不创建临时文件时，这种方法是理想的选择。 了解有关[使用 PDF 内存流](https://ironpdf.com/how-to/pdf-memory-stream/)的更多信息。 ```csharp // Example: Save PDF to MemoryStream using IronPdf; using System.IO; var renderer = new ChromePdfRenderer(); // Render HTML content PdfDocument pdf = renderer.RenderHtmlAsPdf("

Sales figures...

"); // Get the PDF as a MemoryStream MemoryStream stream = pdf.Stream; // Example: Upload to cloud storage or database // UploadToCloudStorage(stream); // Example: Email as attachment without saving to disk // EmailService.SendWithAttachment(stream, "report.pdf"); // Remember to dispose of the stream when done stream.Dispose(); ``` ### 如何保存为二进制数据 [`IronPdf.PdfDocument.BinaryData`](/object-reference/api/IronPdf.PdfDocument.html)属性将 PDF 文档导出为内存中的二进制数据。 这对于数据库存储或与需要字节数组的 API 集成时尤其有用。 这会将 PDF 作为`ByteArray`输出，在 C# 中表示为`byte []`。 ```csharp // Example: Convert PDF to binary data using IronPdf; var renderer = new ChromePdfRenderer(); // Configure rendering options for better quality renderer.RenderingOptions = new ChromePdfRenderOptions() { MarginTop = 20, MarginBottom = 20, MarginLeft = 10, MarginRight = 10, PaperSize = IronPdf.Rendering.PdfPaperSize.A4 }; // Render content to PDF PdfDocument pdf = renderer.RenderHtmlAsPdf(""); // Get binary data byte[] binaryData = pdf.BinaryData; // Example: Store in database // database.StorePdfDocument(documentId, binaryData); // Example: Send via API // apiClient.UploadDocument(binaryData); ``` 有关涉及二进制数据操作的更高级场景，请参阅我们的[将 PDF 转换为 MemoryStream](https://ironpdf.com/how-to/pdf-to-memory-stream/) 指南。 ### 如何从 Web 服务器提供给浏览器 <！--说明：说明代码概念的图表或截图 --> 要将 PDF 提供给网络，我们需要将其作为二进制数据而不是 HTML 发送。 这对于用户需要在浏览器中直接下载或查看 PDF 的网络应用至关重要。 IronPDF 可与 MVC 和传统 ASP.NET 应用程序集成。 #### MVC PDF 导出 在现代 MVC 应用程序中，使用 `FileStreamResult` 直接为 PDF 提供服务。 这种方法对 [ASP.NET Core MVC 应用程序](https://ironpdf.com/how-to/cshtml-to-pdf-mvc-core/)效果很好： ```csharp // MVC Controller method for PDF export public IActionResult DownloadInvoice(int invoiceId) { // Generate your HTML content string htmlContent = GenerateInvoiceHtml(invoiceId); // Create PDF using IronPDF var renderer = new ChromePdfRenderer(); PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); // Get the PDF stream MemoryStream stream = pdf.Stream; // Reset stream position stream.Position = 0; // Return file to browser - will prompt download return new FileStreamResult(stream, "application/pdf") { FileDownloadName = $"invoice_{invoiceId}.pdf" }; } // Alternative: Display PDF in browser instead of downloading public IActionResult ViewInvoice(int invoiceId) { var renderer = new ChromePdfRenderer(); PdfDocument pdf = renderer.RenderHtmlAsPdf(GenerateInvoiceHtml(invoiceId)); // Return PDF for browser viewing return File(pdf.BinaryData, "application/pdf"); } ``` #### ASP.NET PDF 导出 对于传统的 ASP.NET WebForms 应用程序，您可以通过响应对象直接提供 PDF： ```csharp // ASP.NET WebForms PDF export protected void ExportButton_Click(object sender, EventArgs e) { // Create your PDF document var renderer = new ChromePdfRenderer(); // Configure rendering options renderer.RenderingOptions = new ChromePdfRenderOptions() { PaperSize = IronPdf.Rendering.PdfPaperSize.Letter, PrintHtmlBackgrounds = true, CreatePdfFormsFromHtml = true }; // Generate PDF from current page or custom HTML PdfDocument MyPdfDocument = renderer.RenderHtmlAsPdf(GetReportHtml()); // Retrieves the PDF binary data byte[] Binary = MyPdfDocument.BinaryData; // Clears the existing response content Response.Clear(); // Sets the response content type to 'application/octet-stream', suitable for PDF files Response.ContentType = "application/octet-stream"; // Add content disposition header for download Response.AddHeader("Content-Disposition", "attachment; filename=report_" + DateTime.Now.ToString("yyyyMMdd") + ".pdf"); // Writes the binary data to the response output stream Context.Response.OutputStream.Write(Binary, 0, Binary.Length); // Flushes the response to send the data to the client Response.Flush(); // End the response Response.End(); } ``` ## 高级导出场景 <！--说明：显示高级导出选项和结果的屏幕截图 --> ### 批量导出 PDF 文件 在处理多个 PDF 时，可以优化导出过程： ```csharp // Batch export multiple PDFs to a zip file public void ExportMultiplePdfsAsZip(List htmlDocuments, string zipFilePath) { using (var zipArchive = ZipFile.Open(zipFilePath, ZipArchiveMode.Create)) { var renderer = new ChromePdfRenderer(); for (int i = 0; i < htmlDocuments.Count; i++) { // Render each HTML document PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlDocuments[i]); // Add to zip archive var entry = zipArchive.CreateEntry($"document_{i + 1}.pdf"); using (var entryStream = entry.Open()) { pdf.Stream.CopyTo(entryStream); } } } } ``` ### 基于用户权限的有条件导出 ```csharp // Export with different options based on user role public byte[] ExportPdfWithPermissions(string htmlContent, UserRole userRole) { var renderer = new ChromePdfRenderer(); PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); // Apply security based on user role if (userRole == UserRole.Guest) { // Restrict printing and copying for guests pdf.SecuritySettings.AllowUserPrinting = false; pdf.SecuritySettings.AllowUserCopyPasteContent = false; } else if (userRole == UserRole.Standard) { // Allow printing but not editing pdf.SecuritySettings.AllowUserPrinting = true; pdf.SecuritySettings.AllowUserEditing = false; } return pdf.BinaryData; } ``` ## PDF 导出的最佳实践 在生产应用程序中导出 PDF 时，请考虑以下最佳实践： 1.**内存管理**：对于大型 PDF 或高流量应用程序，应正确处理 PDF 对象和流以防止内存泄漏。 考虑使用 `async` 方法以获得更好的性能。 2.**错误处理**：在导出 PDF 时，尤其是在可能出现网络问题的网络应用程序中，始终执行适当的错误处理。 3.**压缩**：对于大型 PDF，在提供给用户之前，请使用 PDF 压缩来减小文件大小。 4.**元数据**：设置适当的 PDF 元数据，包括标题、作者和创建日期，以便更好地管理文件。 5.**跨平台兼容性**：确保您的导出功能可在不同平台上运行。 IronPdf 支持 `Windows`, `Linux` 和 `macOS`. ## 结论 IronPdf 为在 C# 应用程序中导出 PDF 提供了全面的选项，从简单的文件保存到复杂的 Web 服务器场景。 针对您的使用情况使用适当的导出方法，可以让您高效地生成 PDF 文档并交付给用户，同时保持安全性和性能标准。

常见问题解答

如何用 C# 将 HTML 内容导出为 PDF？

您可以使用 IronPDF 的 ChromePdfRenderer 类在 C# 中将 HTML 导出为 PDF。只需创建一个渲染器实例，使用 RenderHtmlAsPdf() 方法转换 HTML 内容，然后使用 SaveAs() 方法保存即可。IronPDF 可轻松地将 HTML 字符串、文件或 URL 直接转换为 PDF 文档。

使用 C# 保存 PDF 的不同方法有哪些？

IronPDF 提供多种保存 PDF 的方法：SaveAs() 用于保存到磁盘，Stream 用于在网络应用程序中提供 PDF 而无需创建临时文件，BinaryData 用于以字节数组的形式获取 PDF。IronPDF 中的每种方法都适用于不同的用例，从简单的文件存储到动态的网络交付。

能否将 PDF 保存到内存而不是磁盘？

是的，IronPDF 允许您使用 System.IO.MemoryStream 将 PDF 保存到内存中。这对于想要直接向用户提供 PDF 而无需在服务器上创建临时文件的网络应用程序非常有用。您可以使用 Stream 属性或将 PDF 转换为二进制数据。

保存 PDF 时如何添加密码保护？

IronPDF 通过在保存前设置 PdfDocument 对象的 Password 属性来实现密码保护。只需将密码字符串赋值给 pdf.Password，然后使用 SaveAs() 创建需要密码才能打开的受保护 PDF 文件即可。

我可以直接向网络浏览器提供 PDF 而不保存到磁盘吗？

是的，IronPDF 允许您将 PDF 文件作为二进制数据直接提供给网络浏览器。您可以使用 BinaryData 属性以字节数组的形式获取 PDF，并通过网络应用程序的响应流提供 PDF，从而无需临时文件存储。

在一行中将 HTML 转换并保存为 PDF 的最简单方法是什么？

IronPDF 提供了单行解决方案：new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Your HTML").SaveAs("output.pdf")。只需一条语句，即可创建渲染器、将 HTML 转换为 PDF 并保存到磁盘。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

审核者
Jeff Fritz
Jeffrey T. Fritz
首席项目经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席项目经理。他是 .NET Conf 虚拟会议系列的执行制片人，并主持“Fritz and Friends”直播节目，每周两次与观众一起谈论技术并编写代码。Jeff 撰写研讨会、演示文稿并计划包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP 峰会在内的最大型微软开发者活动的内容。
准备开始了吗？
Nuget 下载 16,685,821 | 版本: 2025.12 刚刚发布