HTML 到 PDF: C# .NET 的快速教程

如何在C#中将HTML转换为PDF(开发者指南)

This article was translated from English: Does it need improvement?
Translated
View the article in English

用 C# 将 HTML 转换为 PDF 通常看似简单,直到实际需求浮出水面。 开发人员很快就会遇到影响渲染准确性、部署和可扩展性的限制。

除了渲染之外,基础设施的兼容性也至关重要。 团队必须确保 PDF 生成能够在现代 .NET 运行时、云平台和容器化环境中运行,而不会影响性能。

为了弥补这些不足,IronPDF 等基于 Chrome 浏览器的现代解决方案提供了更高的渲染保真度、更广泛的平台支持以及生产就绪的部署工作流程--本指南的其余部分将逐步介绍这些内容。

TL;DR:HTML 转 PDF 快速入门指南

您可以使用 IronPdf 库在 C# 中轻松将 HTML 转换为 PDF,该库提供了 ChromePdfRenderer.RenderHtmlAsPdf 方法,可从 HTML、CSS 和 JavaScript 生成高质量的 PDF 文件。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 复制并运行这段代码。

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronPDF

    arrow pointer

购买或注册 IronPDF 30 天试用版后,请查找发送到您电子邮件中的许可证密钥。 在应用程序开始时添加您的许可密钥。

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf

IronPdf.License.LicenseKey = "KEY"
$vbLabelText   $csharpLabel

为什么.NET开发人员需要C#的HTML转PDF转换器

IronPDF 利用嵌入式 Google Chromium 渲染引擎确保高保真转换,准确保留网页内容的布局和样式。

稳健的 Chrome 浏览器渲染引擎: Chrome 浏览器的 Blink 引擎可将 HTML 准确转换为 PDF,现在又对内存、表单和渲染准确性进行了增强修复(v2025.9.4)

精确到像素:生成的 PDF 与网页精确匹配,而不是打印机友好版本。 最近的修复包括自定义页眉/页脚剪切、灰度文本保存和元数据中的特殊字符/表情符号(截至 v2025.9.4)

全面的现代网络支持:为所有 HTML 元素提供完整的 CSS3、HTML5 和 JavaScript 支持。 最近的增强包括处理长文本框和复选框的表单字段。

性能提升 5-20 倍:速度明显快于浏览器自动化或网络驱动程序,现在还修复了内存泄漏问题,并减少了批量操作中重复元素(如图章/页眉)的文件大小。

PDF/UA 合规性: 生成符合第 508 条标准的无障碍 PDF,并增强跨平台(如 Linux)表单呈现。

无外部依赖性:无需在服务器上安装可执行文件

专为在 .NET 10、9、8、7、6、Core、Standard 或 Framework 上运行的 C#、F# 和 VB.NET 设计

IronPDF 为 .NET 开发人员简化了这一过程,为从您的网络应用程序的 HTML 生成专业外观的 PDF 文档提供了一个直接高效的解决方案。 从发票和报告到证书和档案,开发人员可以使用他们熟悉的网络堆栈工作,而 IronPDF 只需几行代码就能处理复杂的问题。

相关: IronPDF Changelog:更新、里程碑、路线图

您将学到什么

1. 如何将 HTML 转换为 PDF C#

- [如何将 HTML 字符串转换为 PDF](#how-to-convert-html-string-to-pdf)
- [如何将现有 URL 导出到 PDF](#how-to-export-existing-url-to-pdf)
- [如何将 HTML 文件转换为 PDF](#how-to-convert-html-file-to-pdf)

如何将Razor页面转换为PDF 如何将MVC视图转换为PDF

2. 如何配置 HTML 到 PDF 的设置如何设置自定义HTTP头、Cookie和登录凭据 如何配置代理以进行PDF渲染

3. 如何使用高级 PDF 生成和安全功能

- [如何为批量创建 PDF 生成 HTML 模板](#如何为批量创建 PDF 生成 HTML 模板)。
- [如何使用异步方法生成 PDF](#how-to-generate-pdf-using-async-method)
- [如何添加高级安全功能](#如何添加高级安全功能)。

如何将HTML表单转换为可填写的PDF 如何将特定HTML元素转换为PDF 如何将已认证的页面渲染为PDF

  1. 如何在云平台上部署HTML到PDF转换 如何在Azure上部署 如何在AWS Lambda上部署 如何使用Docker部署

  2. 将IronPDF与其他.NET PDF库进行比较

  3. 疑难解答与技术支持

1. How to Convert HTML to PDF C

无论您是处理 HTML 字符串、URL 还是 HTML 文件,IronPDF 都能提供灵活的选项,生成符合您特定要求的高质量 PDF 文档。

在本教程中,我们将引导您了解最常见的情况,包括 HTML 字符串到 PDF、URL 到 PDF 以及 HTML 文件到 PDF。 此外,IronPDF 还提供各种操作 PDF 文档的操作:

如何将 HTML 字符串转换为 PDF 文件

最基本的操作是将 HTML 字符串转换为 PDF。 这种方法非常适合动态生成的 HTML 内容。 当您直接将 HTML 转换为 PDF/A 时,RenderHtmlAsPdf 方法完全支持 HTML5、CSS3、JavaScript 以及图像。

using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");
using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");
Imports IronPdf

' Create the Chrome renderer
Dim renderer As New ChromePdfRenderer()

' Convert HTML string to PDF
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>")

' Save the PDF
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

性能

IronPDF 将字符串、URL 和 HTML 转换为 PDF 的性能测试是在配备 16GB 内存的联想笔记本电脑上进行的。 测试文档是一份 3 页的 Enterprise 发票,其中包含标准的 CSS Grid、渐变效果和多区域表格。

翻译结果如下:

指标 价值
平均渲染时间 ~486 毫秒
每次渲染的内存 ~3.6 MB

在 16 核工作站(Windows 11,.NET 8)上连续渲染 5 次测得。 首次调用还包含一次性的 Chromium 引擎初始化(约 1.3 秒)

我第一次运行测试时,渲染速度非常缓慢(每次调用超过一秒!)。 观察了一会儿后,我意识到当时有多个 Chromium 实例正在运行,而且设备处于电池供电状态,这两点都导致该库无法展现其真正的速度。 关闭竞争进程并连接电源后,运行效率显著提升:预热运行平均耗时约 486 毫秒,最快仅需 473 毫秒。

提示(已更新至 v2025.9.4) 最近的更新修复了 HTML 元数据中的特殊字符/表情符号的问题,并确保更好地处理 html 表单字段,包括 Linux 上的中文字符。 使用 测试动态内容

当您的 HTML 字符串引用图片或样式表等本地资源时,请使用 BaseUrlPath 参数,以正确转换包含所有资源的 HTML 内容:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert HTML content with local image and CSS references
Dim html As String = "
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>"

' Set base path for resolving relative URLs in HTML to PDF conversion
Dim pdf = renderer.RenderHtmlAsPdf(html, "C:\MyProject\Assets\")
pdf.SaveAs("report.pdf")
$vbLabelText   $csharpLabel

提示BaseUrlPath 告诉IronPDF在哪里可以找到你的 CSS、 JavaScript和图像文件。 HTML 字符串中的所有相对路径都将从此目录解析。

警告一个需要注意的问题是,无论使用何种库进行自动化文档生成,测试输出结果都至关重要,因为当引用默认回退到系统设置时,Enterprise文档中可能会出现损坏的元素或缺失的资源。 IronPDF 提供了 BaseUrlPath 参数,用于将相对路径指向正确的目录,因此通常只需在批量运行前快速检查输出即可发现问题。

RELATED HOW-TO ARTICLE: 如何用 C# 将 HTML 字符串转换为 PDF

如何将现有 URL 导出到 PDF.

using C# 将整个网页渲染为 PDF,使团队能够将 PDF 设计和后端渲染工作分开。 通过这种方法,您可以将任何指定的 URL 直接转换为 PDF 格式。

打印与屏幕 CSS 对比

您可以将 IronPDF 配置为使用任一种 CSS 媒体类型呈现。

using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen
using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen
Imports IronPdf
Imports IronPdf.Rendering

' Initialize HTML to PDF converter
Dim renderer As New ChromePdfRenderer()

' Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print

' Screen media type shows the entire web page as displayed on screen
$vbLabelText   $csharpLabel

JavaScript 支持

在将 HTML 转换为 PDF 时,IronPDF 完全支持 JavaScript、jQuery 甚至 AJAX。 对于动态 HTML 内容,您可以配置 IronPDF 等待 JavaScript 完成后再将网页渲染为 PDF。 这非常适合单页应用程序和动态网站。

using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds
using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds
Imports IronPdf

' Configure JavaScript rendering for dynamic HTML content to PDF
Dim renderer As New ChromePdfRenderer()

' Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = True

' WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500 ' milliseconds
$vbLabelText   $csharpLabel

在将高级 d3.js 和弦图从网页渲染为 PDF 格式时,还可以显示 JavaScript 的执行情况:

using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");
using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");
Imports IronPdf

' Create renderer for JavaScript-heavy HTML
Dim renderer As New ChromePdfRenderer()

' Convert d3.js visualization web page to PDF
Dim pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006")

' Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf")
$vbLabelText   $csharpLabel

响应式 CSS

由于响应式网页是为在浏览器中浏览而设计的,且 IronPDF 不会在服务器操作系统中打开真正的浏览器窗口,因此响应式 HTML 元素可能会以最小尺寸渲染。建议使用 PdfCssMediaType.Print 来解决渲染整个网页时出现的问题。

// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
```vbnet
' Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
```
$vbLabelText   $csharpLabel

相关 "如何 "文章: 如何将 URL 渲染为 PDF

如何将 HTML 文件转换为 PDF 文件

将本地 HTML 文件转换为 PDF 时会保留所有相关资产,包括 CSS、图像和 JavaScript,就像使用 file:// 协议打开一样。 这种 HTML 转 PDF 的方法最适合将模板或预先设计好的 HTML 页面转换为 PDF 文档。

using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF
using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF
Imports IronPdf

' Initialize ChromePdfRenderer for HTML file conversion
Dim renderer As New ChromePdfRenderer()

' Convert HTML file to PDF documents
' Preserves all relative paths and linked resources in HTML
Dim pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html")

' Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf")

' All CSS, JavaScript, and images load correctly in the generated PDF
$vbLabelText   $csharpLabel

性能

通过将所有变量保持恒定,再次测量了性能,以渲染来自磁盘文件中的那份 3 页 Enterprise 发票:

指标 价值
平均渲染时间 ~502 毫秒
每次渲染的内存 ~3.1 MB

在同一台 16 核工作站(Windows 11,.NET 8)上连续渲染 5 次测得。 基于文件的渲染与内存中字符串渲染的误差在 3% 左右; 从磁盘读取 HTML 不会增加可测量的开销。

将 HTML 文件及其资源(CSS、图像)放在单独的文件夹中,以便在将 HTML 文件转换为 PDF 之前在浏览器中进行编辑和测试。 这样可以确保您的 HTML 代码完美渲染,从而生成高质量的 PDF 文档。

相关 "如何做 "文章: 将 HTML 文件渲染为 PDF

如何将Razor页面转换为PDF

如果您的ASP.NET Core项目已经使用Razor Pages,您可以直接将它们转换为PDF,而无需重新构建HTML。 IronPDF 的 Razor 扩展添加了 RenderRazorToPdf 方法,该方法可将您的 .cshtml 页面(包含其模型和布局)通过单次调用渲染为 PDF 文档。

PM > Install-包 IronPdf.Extensions.Razor
PM > Install-包 IronPdf.Extensions.Razor
SHELL
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class ReportModel : PageModel
{
    public IActionResult OnGet()
    {
        var renderer = new ChromePdfRenderer();

        // Render a Razor Page directly to PDF
        PdfDocument pdf = renderer.RenderRazorToPdf(this);

        Response.Headers.Add("Content-Disposition", "inline");
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class ReportModel : PageModel
{
    public IActionResult OnGet()
    {
        var renderer = new ChromePdfRenderer();

        // Render a Razor Page directly to PDF
        PdfDocument pdf = renderer.RenderRazorToPdf(this);

        Response.Headers.Add("Content-Disposition", "inline");
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports Microsoft.AspNetCore.Mvc.RazorPages

Public Class ReportModel
    Inherits PageModel

    Public Function OnGet() As IActionResult
        Dim renderer As New ChromePdfRenderer()

        ' Render a Razor Page directly to PDF
        Dim pdf As PdfDocument = renderer.RenderRazorToPdf(Me)

        Response.Headers.Add("Content-Disposition", "inline")
        Return New FileContentResult(pdf.BinaryData, "application/pdf")
    End Function
End Class
$vbLabelText   $csharpLabel

请注意RenderRazorToPdf需要一个ASP.NET Core Web应用项目。 它不适用于控制台应用程序或类库——Razor视图引擎必须在托管管道中可用。)}]

相关的操作指南: 如何在Razor页面中将CSHTML转换为PDF

如何将MVC视图转换为PDF

使用MVC模式的团队可以直接从现有的视图和控制器生成PDF。 安装 MVC Core 扩展包,然后使用视图路径和模型调用 RenderRazorViewToPdf —— IronPDF 会处理 Razor 渲染管道并输出最终的 PDF 文件。

这对于报告、发票以及任何已在浏览器中设计和测试的HTML页面特别有用。 生成的PDF保留完整的视图输出,包括布局页面和部分视图。

PM > Install-包 IronPdf.Extensions.Mvc.Co/re
PM > Install-包 IronPdf.Extensions.Mvc.Co/re
SHELL

首先,在 Program.cs 中注册 IRazorViewRenderer 服务,以便您的控制器能够注入该服务:

using IronPdf.Extensions.Mvc.Co/re;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register the Razor view renderer for IronPDF
builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();
using IronPdf.Extensions.Mvc.Co/re;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register the Razor view renderer for IronPDF
builder.Services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();
Imports IronPdf.Extensions.Mvc.Core

Dim builder = WebApplication.CreateBuilder(args)
builder.Services.AddControllersWithViews()

' Register the Razor view renderer for IronPDF
builder.Services.AddSingleton(Of IHttpContextAccessor, HttpContextAccessor)()
builder.Services.AddSingleton(Of IRazorViewRenderer, RazorViewRenderer)()
$vbLabelText   $csharpLabel

然后在您的控制器操作中,注入渲染器并将任何视图转换为PDF:

using IronPdf;
using IronPdf.Extensions.Mvc.Co/re;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    private readonly IRazorViewRenderer _viewRenderService;

    // Inject the view renderer via constructor
    public ReportController(IRazorViewRenderer viewRenderService)
    {
        _viewRenderService = viewRenderService;
    }

    public IActionResult Download()
    {
        var reportModel = new { Title = "Quarterly Report", Total = 1250.00 };
        var renderer = new ChromePdfRenderer();

        // Render an MVC View with model data to PDF
        PdfDocument pdf = renderer.RenderRazorViewToPdf(
            _viewRenderService, "Views/Home/Report.cshtml", reportModel);

        Response.Headers.Add("Content-Disposition", "inline");
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}
using IronPdf;
using IronPdf.Extensions.Mvc.Co/re;
using Microsoft.AspNetCore.Mvc;

public class ReportController : Controller
{
    private readonly IRazorViewRenderer _viewRenderService;

    // Inject the view renderer via constructor
    public ReportController(IRazorViewRenderer viewRenderService)
    {
        _viewRenderService = viewRenderService;
    }

    public IActionResult Download()
    {
        var reportModel = new { Title = "Quarterly Report", Total = 1250.00 };
        var renderer = new ChromePdfRenderer();

        // Render an MVC View with model data to PDF
        PdfDocument pdf = renderer.RenderRazorViewToPdf(
            _viewRenderService, "Views/Home/Report.cshtml", reportModel);

        Response.Headers.Add("Content-Disposition", "inline");
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}
Imports IronPdf
Imports IronPdf.Extensions.Mvc.Core
Imports Microsoft.AspNetCore.Mvc

Public Class ReportController
    Inherits Controller

    Private ReadOnly _viewRenderService As IRazorViewRenderer

    ' Inject the view renderer via constructor
    Public Sub New(viewRenderService As IRazorViewRenderer)
        _viewRenderService = viewRenderService
    End Sub

    Public Function Download() As IActionResult
        Dim reportModel = New With {.Title = "Quarterly Report", .Total = 1250.0}
        Dim renderer = New ChromePdfRenderer()

        ' Render an MVC View with model data to PDF
        Dim pdf As PdfDocument = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Home/Report.cshtml", reportModel)

        Response.Headers.Add("Content-Disposition", "inline")
        Return New FileContentResult(pdf.BinaryData, "application/pdf")
    End Function
End Class
$vbLabelText   $csharpLabel

相关的操作指南: 如何在ASP.NET Core MVC中将视图转换为PDF

2.如何配置 HTML 转 PDF 设置

在 PDF 文档处理方面,IronPDF 通过 ChromePdfRenderer.RenderingOptions 属性为渲染后的 PDF 提供了丰富的自定义选项。

设置 描述 示例
PaperSize 为现有 PDF 文件设置页面尺寸(A4、Letter、Legal 等) PdfPaperSize.A4
PaperOrientation 为现有 PDF 设置纵向或横向 PdfPaperOrientation.Landscape
MarginTop/Bottom/Left/Right 以毫米为单位设置页边距(默认值:25 毫米)
CssMediaType 将 CSS 从 HTML 转换为 PDF 的屏幕或打印 PdfCssMediaType.Print
PrintHtmlBackgrounds 包含背景颜色/图像(默认值:true) 真实
启用JavaScript 在呈现 HTML 内容之前执行 JavaScript 真实
WaitFor.RenderDelay 动态 HTML 内容的等待时间(毫秒) 500

有关操作 PDF 文档的完整配置示例,请参见本代码片段:

using IronPdf;
using IronPdf.Rendering;

var renderer = new ChromePdfRenderer();

// Apply print-specific CSS rules
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Set custom margins in millimeters
renderer.RenderingOptions.MarginTop = 50;
renderer.RenderingOptions.MarginBottom = 50;

// Enable background colors and images
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

// Generate PDFs with all settings applied to HTML content
var htmlContent = "<div style='background-color: #f0f0f0; padding: 20px;'><h1>Styled Content</h1></div>";
var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
pdfDocument.SaveAs("styled-output.pdf");
using IronPdf;
using IronPdf.Rendering;

var renderer = new ChromePdfRenderer();

// Apply print-specific CSS rules
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Set custom margins in millimeters
renderer.RenderingOptions.MarginTop = 50;
renderer.RenderingOptions.MarginBottom = 50;

// Enable background colors and images
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

// Generate PDFs with all settings applied to HTML content
var htmlContent = "<div style='background-color: #f0f0f0; padding: 20px;'><h1>Styled Content</h1></div>";
var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
pdfDocument.SaveAs("styled-output.pdf");
Imports IronPdf
Imports IronPdf.Rendering

Dim renderer As New ChromePdfRenderer()

' Apply print-specific CSS rules
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print

' Set custom margins in millimeters
renderer.RenderingOptions.MarginTop = 50
renderer.RenderingOptions.MarginBottom = 50

' Enable background colors and images
renderer.RenderingOptions.PrintHtmlBackgrounds = True

' Set paper size and orientation
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape

' Generate PDFs with all settings applied to HTML content
Dim htmlContent As String = "<div style='background-color: #f0f0f0; padding: 20px;'><h1>Styled Content</h1></div>"
Dim pdfDocument As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
pdfDocument.SaveAs("styled-output.pdf")
$vbLabelText   $csharpLabel

提示在渲染的 PDF 文件格式中使用 PdfCssMediaType 可以获得更清晰、更适合打印的布局。 使用 Screen 来精确匹配用户在浏览器中看到的内容。

相关 "如何做 "文章:

如何设置自定义HTTP头、Cookie和登录凭据

当渲染需要身份验证或特定请求元数据的URL时,IronPDF允许您在请求中包含登录凭据、会话Cookie和HTTP头。这样可以直接将内部网仪表板、限制性报告或API生成的页面直接渲染为PDF,而无需单独检索HTML。

对于基本或 NTLM 身份验证,请在渲染器上设置一个 LoginCredentials 对象。 对于基于令牌或会话的访问,请在调用 RenderUrlAsPdf 之前,通过 RenderingOptions 传递 Cookie 和请求头。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword"
};

// Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123";

// Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/quarterly-report");
pdf.SaveAs("quarterly-report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword"
};

// Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123";

// Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/quarterly-report");
pdf.SaveAs("quarterly-report.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Network authentication (Basic, Digest, NTLM)
renderer.LoginCredentials = New ChromeHttpLoginCredentials With {
    .NetworkUsername = "user@domain.com",
    .NetworkPassword = "securePassword"
}

' Session cookies for authenticated pages
renderer.RenderingOptions.CustomCookies("sessionId") = "abc123"

' Custom HTTP headers (e.g., Bearer tokens, API keys)
renderer.RenderingOptions.CustomHttpRequestHeaders("Authorization") = "Bearer eyJhbGciOi..."

Dim pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/quarterly-report")
pdf.SaveAs("quarterly-report.pdf")
$vbLabelText   $csharpLabel

相关的操作指南: 如何在登录身份验证后渲染PDF |自定义HTTP请求头

如何配置代理以进行PDF渲染

在渲染通过企业代理加载外部资源的 HTML 时,请将代理地址作为 RenderHtmlAsPdf() 的第三个参数传递。 这是一个方法参数,而非 ChromePdfRenderOptions 上的属性——因此它是按每次渲染调用设置的,而非在渲染器实例上设置。

对于需要身份验证的代理,请使用 http://user:pass@host:port 格式将凭据直接嵌入 URL 中。 密码中的特殊字符请使用 Uri.EscapeDataString() 进行 URL 编码。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Proxy is the third parameter — not a render option
PdfDocument pdf = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath: null,
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("proxied-report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Proxy is the third parameter — not a render option
PdfDocument pdf = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath: null,
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("proxied-report.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Proxy is the third parameter — not a render option
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(
    "<h1>Report</h1><link rel='stylesheet' href='https://cdn.example.com/styles.css'>",
    baseUrlOrPath:=Nothing,
    proxy:="http://proxy.co/rp.local:8080"
)
pdf.SaveAs("proxied-report.pdf")
$vbLabelText   $csharpLabel

请注意,RenderUrlAsPdf() 不接受代理参数。 要渲染位于代理服务器后方的实时 URL,请先使用配置了 WebProxyHttpClient 获取 HTML,然后将其传递给 RenderHtmlAsPdf(),并带上代理参数以加载资源。

相关的操作指南: 如何为PDF渲染配置代理服务器

3.如何使用高级 PDF 生成和安全功能

通过高级模板、异步操作和安全功能,解锁 HTML 到 PDF 转换的企业级功能。 这些 PDF 操作方法可以让您大规模创建 PDF 文档,保护敏感的 PDF 文件,并在将 HTML 转换为专业 PDF 格式时确保文档的真实性。

如何生成用于批量创建 PDF 的 HTML 模板

基本批量 PDF 创建

批量创建 PDF 对于高效生成多个个性化 PDF 文档至关重要。 对于基本场景,C# 中的 String.Format 方法最适合进行简单的 PDF 操作。

// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>
// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>
' Simple HTML templating with String.Format
Dim htmlTemplate As String = String.Format("<h1>Hello {0}!</h1>", "World")

' Results in HTML content: <h1>Hello World!</h1>
$vbLabelText   $csharpLabel

对于需要生成 PDF 文档的较长模板,请在 HTML 内容中使用占位符替换:

using IronPdf;

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}
using IronPdf;

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}
Imports IronPdf

' Define reusable HTML template for PDF files
Dim htmlTemplate As String = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>"

' Customer names for batch PDF conversion processing
Dim names As String() = {"John", "James", "Jenny"}

' Create personalized PDF documents for each customer
Dim renderer As New ChromePdfRenderer()

For Each name In names
    ' Replace placeholder with actual data in HTML string
    Dim htmlInstance As String = htmlTemplate.Replace("[[NAME]]", name)

    ' Generate personalized PDF document from HTML content
    Dim pdf = renderer.RenderHtmlAsPdf(htmlInstance)

    ' Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf")
Next
$vbLabelText   $csharpLabel

使用 Handlebars.NET 将 HTML 转换为 PDF 模板

对于包含循环和条件语句的复杂模板,在将 HTML 转换为 PDF 时,请使用 Handlebars.NET 进行高级模板处理,以生成包含动态 HTML 内容的 PDF 文档。

# First, install Handlebars.NET for HTML to PDF templating
PM > Install-包 Handlebars.NET
# First, install Handlebars.NET for HTML to PDF templating
PM > Install-包 Handlebars.NET
SHELL
using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Com/pile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");
using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Com/pile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");
Imports HandlebarsDotNet
Imports IronPdf

' Define Handlebars template with placeholders for HTML content
Dim source As String = 
    "<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>"

' Compile template for reuse in PDF conversion
Dim template = Handlebars.Compile(source)

' Create data object (can be database records) for HTML to PDF directly
Dim data = New With { 
    .title = "Monthly Report", 
    .body = "Sales increased by 15% this month." 
}

' Merge template with data to create HTML content
Dim htmlResult = template(data)

' Convert templated HTML to PDF using the PDF converter
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlResult)

pdf.SaveAs("monthly-report.pdf")
$vbLabelText   $csharpLabel

相关的教程文章: 在GitHub上了解更多关于Handlebars.NET的信息

控制 PDF 断页:

在转换 HTML 片段时,管理生成 PDF 文档中的分页可确保布局专业、可读性强。使用 CSS 控制 PDF 文件中分页的位置。
<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>
<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>
HTML

如何使用异步方法生成 PDF.

当您需要大规模生成 PDF 文件时,IronPDF 可提供企业级性能,支持完全异步和多线程,满足 HTML 到 PDF 的转换要求。

using IronPdf;
using System.Co/llections.Generic;
using System.Linq;
using System.Threading.Tasks;

public class PdfGenerationService
{
    // Async method for non-blocking PDF generation from HTML content
    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        var renderer = new ChromePdfRenderer();

        // Async HTML to PDF conversion preserves thread pool
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);

        // Return PDF files as byte array for web responses
        return pdf.BinaryData;
    }

    // Concurrent batch PDF generation for multiple HTML strings
    public async Task GenerateMultiplePdfsAsync(List<string> html模板)
    {
        var renderer = new ChromePdfRenderer();

        // Create parallel conversion tasks to generate PDF documents
        var tasks = html模板.Select(html =>
            renderer.RenderHtmlAsPdfAsync(html)
        );

        // Await all PDF conversions simultaneously
        var pdfs = await Task.WhenAll(tasks);

        // Save generated PDF files from HTML content
        for (int i = 0; i < pdfs.Length; i++)
        {
            pdfs[i].SaveAs($"document-{i}.pdf");
        }
    }
}
using IronPdf;
using System.Co/llections.Generic;
using System.Linq;
using System.Threading.Tasks;

public class PdfGenerationService
{
    // Async method for non-blocking PDF generation from HTML content
    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        var renderer = new ChromePdfRenderer();

        // Async HTML to PDF conversion preserves thread pool
        var pdf = await renderer.RenderHtmlAsPdfAsync(html);

        // Return PDF files as byte array for web responses
        return pdf.BinaryData;
    }

    // Concurrent batch PDF generation for multiple HTML strings
    public async Task GenerateMultiplePdfsAsync(List<string> html模板)
    {
        var renderer = new ChromePdfRenderer();

        // Create parallel conversion tasks to generate PDF documents
        var tasks = html模板.Select(html =>
            renderer.RenderHtmlAsPdfAsync(html)
        );

        // Await all PDF conversions simultaneously
        var pdfs = await Task.WhenAll(tasks);

        // Save generated PDF files from HTML content
        for (int i = 0; i < pdfs.Length; i++)
        {
            pdfs[i].SaveAs($"document-{i}.pdf");
        }
    }
}
Imports IronPdf
Imports System.Collections.Generic
Imports System.Linq
Imports System.Threading.Tasks

Public Class PdfGenerationService
    ' Async method for non-blocking PDF generation from HTML content
    Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte())
        Dim renderer As New ChromePdfRenderer()

        ' Async HTML to PDF conversion preserves thread pool
        Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)

        ' Return PDF files as byte array for web responses
        Return pdf.BinaryData
    End Function

    ' Concurrent batch PDF generation for multiple HTML strings
    Public Async Function GenerateMultiplePdfsAsync(html模板 As List(Of String)) As Task
        Dim renderer As New ChromePdfRenderer()

        ' Create parallel conversion tasks to generate PDF documents
        Dim tasks = html模板.Select(Function(html) renderer.RenderHtmlAsPdfAsync(html))

        ' Await all PDF conversions simultaneously
        Dim pdfs = Await Task.WhenAll(tasks)

        ' Save generated PDF files from HTML content
        For i As Integer = 0 To pdfs.Length - 1
            pdfs(i).SaveAs($"document-{i}.pdf")
        Next
    End Function
End Class
$vbLabelText   $csharpLabel

提示HTML 转 PDF 性能优化技巧

  • 使用 64 位系统以获得最佳的 PDF 生成性能。
  • 生成 PDF 文档时确保有足够的服务器资源(避免功率不足的免费层)
  • 为 HTML 内容中复杂的 JavaScript 留出足够的渲染延迟(RenderDelay)。
  • 尽可能复用 ChromePdfRenderer 的实例。
  • 利用 v2025.9.4 对批处理/同步操作的内存修复来减少资源使用; 测试通过重复自定义页眉/页脚来缩小文件大小。

相关 "如何 "文章: 如何使用异步和多线程生成 PDF

如何添加高级安全功能

如何在 .NET 中为 PDF 文件添加密码保护

将 HTML 内容转换为受保护的 PDF 格式时,使用密码和权限保护生成的敏感 PDF 文档。

using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");
using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Convert HTML to PDF with security
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>")

' Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123"     ' Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456"   ' Password to modify PDF files

' Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserAnnotations = False
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint

' Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256
pdf.SaveAs("secure-document.pdf")
$vbLabelText   $csharpLabel

如何在 PDF 文件中添加数字签名

从 HTML 内容生成 PDF 文件时,添加加密签名以确保 PDF 文档的真实性。

using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");
using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");
Imports IronPdf
Imports IronPdf.Signing

Dim renderer As New ChromePdfRenderer()

' Generate PDF from HTML page
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>")

' Create digital signature with certificate for PDF files
Dim signature As New PdfSignature("certificate.pfx", "password") With {
    .SigningContact = "legal@company.com",
    .SigningLocation = "New York, NY",
    .SigningReason = "Contract Approval",
    .SignerName = "Authorized Signer"  ' New property in v2025.8.8 for enhanced signature details
}

' Apply signature to PDF documents
pdf.Sign(signature)
pdf.SaveAs("signed-contract.pdf")
$vbLabelText   $csharpLabel

相关的 HOW-TO 文章: 使用 C# 对 PDF 文档进行数字签名

如何将HTML表单转换为可填写的PDF

要将标准 HTML 表单元素转换为可交互、可填写的 PDF 表单字段,请启用 CreatePdfFormsFromHtml 渲染选项。 这会在生成的PDF文档中将文本输入、复选框、单选按钮和下拉菜单保留为可编辑字段。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string htmlForm = @"
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>";

var pdf = renderer.RenderHtmlAsPdf(htmlForm);
pdf.SaveAs("onboarding-form.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

string htmlForm = @"
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>";

var pdf = renderer.RenderHtmlAsPdf(htmlForm);
pdf.SaveAs("onboarding-form.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Enable HTML form to PDF form conversion
renderer.RenderingOptions.CreatePdfFormsFromHtml = True

Dim htmlForm As String = "
    <h2>Employee Onboarding Form</h2>
    <form>
        <label>Full Name:</label>
        <input type='text' name='fullName' value='' /><br/>
        <label>Department:</label>
        <select name='department'>
            <option value='engineering'>Engineering</option>
            <option value='marketing'>Marketing</option>
            <option value='sales'>Sales</option>
        </select><br/>
        <label>Agree to Terms:</label>
        <input type='checkbox' name='agreeTerms' />
    </form>"

Dim pdf = renderer.RenderHtmlAsPdf(htmlForm)
pdf.SaveAs("onboarding-form.pdf")
$vbLabelText   $csharpLabel

警告HTML 中的每个表单字段都必须具有一个唯一的 name 属性。 重复的名称将在生成的PDF中导致字段共享相同的值,会导致用户填写表单时出现意外行为。)}]

相关的操作指南: 如何在C#中创建可填写的PDF表单

如何将特定HTML元素转换为PDF

要呈现页面的特定部分而不是整个文档,请在渲染之前隔离目标元素。 最直接的方法是使用 JavaScript 渲染选项将文档正文替换为目标元素的内容,并结合 WaitFor.HtmlQuerySelector() 确保在提取前该元素确实存在。 下方的代码片段保留了 document.head,以确保样式表和字体得以保留——若省略此步骤,依赖祖先选择器的 CSS 规则将在生成的 PDF/A 中丢失。

在可访问原始 HTML 的服务器端场景中,请使用 AngleSharp 等解析器提取目标片段,并将其传递给 RenderHtmlAsPdf() —— 无需执行 JavaScript。

using IronPdf;

// Full page HTML containing the target element
string fullPageHtml = @"
<html>
<body>
    <header><h1>Acme Corp Invoice</h1></header>
    <div id='invoice-summary'>
        <h2>Invoice #12345</h2>
        <p>Total: $1,250.00</p>
    </div>
    <footer>Confidential</footer>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;

// Replace the body with only the target element
renderer.RenderingOptions.JavaScript = @"
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
";

// Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000);

var pdf = renderer.RenderHtmlAsPdf(fullPageHtml);
pdf.SaveAs("invoice-summary.pdf");
using IronPdf;

// Full page HTML containing the target element
string fullPageHtml = @"
<html>
<body>
    <header><h1>Acme Corp Invoice</h1></header>
    <div id='invoice-summary'>
        <h2>Invoice #12345</h2>
        <p>Total: $1,250.00</p>
    </div>
    <footer>Confidential</footer>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;

// Replace the body with only the target element
renderer.RenderingOptions.JavaScript = @"
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
";

// Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000);

var pdf = renderer.RenderHtmlAsPdf(fullPageHtml);
pdf.SaveAs("invoice-summary.pdf");
Imports IronPdf

' Full page HTML containing the target element
Dim fullPageHtml As String = "
<html>
<body>
    <header><h1>Acme Corp Invoice</h1></header>
    <div id='invoice-summary'>
        <h2>Invoice #12345</h2>
        <p>Total: $1,250.00</p>
    </div>
    <footer>Confidential</footer>
</body>
</html>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True

' Replace the body with only the target element
renderer.RenderingOptions.JavaScript = "
    var el = document.querySelector('#invoice-summary');
    if (el) {
        var head = document.head.innerHTML;
        document.body.innerHTML = el.outerHTML;
        document.head.innerHTML = head;
    }
"

' Wait for the target element before JS executes
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("#invoice-summary", 10000)

Dim pdf = renderer.RenderHtmlAsPdf(fullPageHtml)
pdf.SaveAs("invoice-summary.pdf")
$vbLabelText   $csharpLabel

相关的操作指南: 如何将HTML元素和部分页面转换为PDF

如何将已认证的页面渲染为PDF

有三种机制用于渲染位于身份验证之后的页面:网络登录凭据、自定义Cookie和HTTP请求头。 这些涵盖了在将受保护的网页内容转换为PDF时最常见的身份验证场景。

登录凭据

将受保护的 URL 转换为 PDF 时,请使用 ChromeHttpLoginCredentials 表示基本、摘要或 NTLM 身份验证。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure network authentication
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword",
    AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
};

var pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/reports");
pdf.SaveAs("authenticated-report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure network authentication
renderer.LoginCredentials = new ChromeHttpLoginCredentials
{
    NetworkUsername = "user@domain.com",
    NetworkPassword = "securePassword",
    AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
};

var pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/reports");
pdf.SaveAs("authenticated-report.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Configure network authentication
renderer.LoginCredentials = New ChromeHttpLoginCredentials With {
    .NetworkUsername = "user@domain.com",
    .NetworkPassword = "securePassword",
    .AuthenticationType = ChromeHttpLoginCredentials.AuthType.Basic
}

Dim pdf = renderer.RenderUrlAsPdf("https://intranet.com/pany.com/reports")
pdf.SaveAs("authenticated-report.pdf")
$vbLabelText   $csharpLabel

Cookie和HTTP头

对于基于令牌或会话的身份验证,将自定义Cookie和HTTP头直接附加到渲染请求中。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Add session cookies
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123token";
renderer.RenderingOptions.CustomCookies["authToken"] = "bearer-xyz";

// Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard");
pdf.SaveAs("dashboard.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Add session cookies
renderer.RenderingOptions.CustomCookies["sessionId"] = "abc123token";
renderer.RenderingOptions.CustomCookies["authToken"] = "bearer-xyz";

// Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders["Authorization"] = "Bearer eyJhbGciOi...";

var pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard");
pdf.SaveAs("dashboard.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Add session cookies
renderer.RenderingOptions.CustomCookies("sessionId") = "abc123token"
renderer.RenderingOptions.CustomCookies("authToken") = "bearer-xyz"

' Add custom HTTP headers (e.g., API key or Bearer token)
renderer.RenderingOptions.CustomHttpRequestHeaders("Authorization") = "Bearer eyJhbGciOi..."

Dim pdf = renderer.RenderUrlAsPdf("https://app.example.com/dashboard")
pdf.SaveAs("dashboard.pdf")
$vbLabelText   $csharpLabel

提示对于基于 HTML 表单的登录(POST 用户名/密码),建议先使用 HttpClient 进行身份验证,然后将生成的 Cookie 传递给 CustomCookies 字典以渲染受保护的页面。

相关的操作指南: 如何将登录身份验证后的HTML转换为PDF

4. 如何在云平台上部署HTML到PDF转换

在云环境中部署HTML到PDF转换需要针对无头渲染、临时文件路径和资源分配进行特定配置。 本节涵盖了IronPDF的最常见云平台和容器化部署。

平台 最小资源 自动配置 临时路径 关键问题
Azure应用服务 B1层(基本) IronPdf.Linux true /tmp 免费/共享层失败——无GPU,内存低
Azure Functions(Windows) B1层 IronPdf true /tmp 取消选中"从包文件运行"
AWS Lambda 512 MB / 330s超时 IronPdf.Linux true /tmp(必需) 默认文件系统是只读的
Docker(Ubuntu/Debian) 取决于镜像 IronPdf.Linux false 镜像默认 设置false——Dockerfile处理依赖

如何在Azure上部署

在部署到Azure Functions或应用服务时,禁用GPU加速,并确保您的托管层提供足够的内存用于基于Chrome的渲染。 在应用程序启动时添加这些设置,任何渲染调用之前。

Azure沙箱以无头模式运行,无法访问GPU,免费/共享层(F1,D1)缺乏Chrome所需的资源。 选择目标为B1(基本)层或更高。

using IronPdf;

// Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependencies自动配置 = true;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>");
pdf.SaveAs("azure-report.pdf");
using IronPdf;

// Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependencies自动配置 = true;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>");
pdf.SaveAs("azure-report.pdf");
Imports IronPdf

' Azure sandboxes block GPU access — always disable
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
' Required on non-GUI Linux systems
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Azure PDF Report</h1>")
pdf.SaveAs("azure-report.pdf")
$vbLabelText   $csharpLabel

注意Azure应用服务免费和共享层(F1,D1)没有足够的资源用于基于Chrome的PDF渲染。 至少使用B1(基本)层或更高以避免内存不足错误和进程超时。)}]

相关入门指南: 如何在Azure上部署IronPDF

如何在AWS Lambda上部署

AWS Lambda需要基于Docker的部署以进行基于Chrome的PDF渲染。 默认的 Lambda 文件系统为只读模式,因此所有临时文件和部署路径必须指向 /tmp

在函数处理程序的顶部配置这些设置,任何渲染调用之前。

using Amazon.Lambda.Co/re;
using IronPdf;

public class PdfFunction
{
    public string FunctionHandler(string input, ILambdaContext context)
    {
        // Lambda's only writable directory
        var tmpPath = "/tmp/";

        IronPdf.Installation.TempFolderPath = tmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
        // Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependencies自动配置 = true;

        context.Logger.LogLine("Rendering PDF...");

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(input);

        // Save to /tmp before uploading to S3 or returning
        var outputPath = $"{tmpPath}output.pdf";
        pdf.SaveAs(outputPath);

        return outputPath;
    }
}
using Amazon.Lambda.Co/re;
using IronPdf;

public class PdfFunction
{
    public string FunctionHandler(string input, ILambdaContext context)
    {
        // Lambda's only writable directory
        var tmpPath = "/tmp/";

        IronPdf.Installation.TempFolderPath = tmpPath;
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
        // Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependencies自动配置 = true;

        context.Logger.LogLine("Rendering PDF...");

        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(input);

        // Save to /tmp before uploading to S3 or returning
        var outputPath = $"{tmpPath}output.pdf";
        pdf.SaveAs(outputPath);

        return outputPath;
    }
}
Imports Amazon.Lambda.Core
Imports IronPdf

Public Class PdfFunction
    Public Function FunctionHandler(input As String, context As ILambdaContext) As String
        ' Lambda's only writable directory
        Dim tmpPath As String = "/tmp/"

        IronPdf.Installation.TempFolderPath = tmpPath
        IronPdf.Installation.CustomDeploymentDirectory = tmpPath
        IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
        ' Let IronPDF install Chrome dependencies on first cold start
        IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

        context.Logger.LogLine("Rendering PDF...")

        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(input)

        ' Save to /tmp before uploading to S3 or returning
        Dim outputPath As String = $"{tmpPath}output.pdf"
        pdf.SaveAs(outputPath)

        Return outputPath
    End Function
End Class
$vbLabelText   $csharpLabel

请注意将您的Lambda函数配置为至少512 MB的内存和最少60秒超时。 基于Chrome的渲染占用大量内存,冷启动需要额外的初始化时间来初始化嵌入的浏览器引擎。)}]

相关入门指南: 如何在AWS Lambda上部署IronPDF

如何使用Docker部署

对于 Docker 部署,请使用 IronPdf.Linux NuGet 包来减小镜像大小并避免运行时资源下载。 该包包含预先打包的优化容器化环境的Linux原生二进制文件。

如果您的 Dockerfile 已通过 apt-get 安装了 Chrome 的共享库依赖项,请设置 LinuxAndDockerDependencies自动配置 = false。 在此情况下,运行时自动安装是多余的,并可能导致权限错误或较长的冷启动时间。

平台 关键配置
Ubuntu 22.04 / Debian IronPdf.Linux 默认——开箱即用
Alpine Linux IronPdf.Linux 在Dockerfile中通过apk安装chromium
Amazon Linux 2 IronPdf.Linux 使用LinuxAndDockerDependencies自动配置 = true
Windows容器 IronPdf 无需额外配置


适用于基于Ubuntu/Debian镜像的最小多阶段Dockerfile:

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app
COPY . .
RUN dotnet publish -c Release -o /out

FROM mcr.microsoft.com/dotnet/aspnet:8.0
# Install Chrome dependencies for PDF rendering
RUN apt-get update && apt-get install -y \
    libglib2.0-0 libnss3 libatk1.0-0 libatk-bridge2.0-0 \
    libcups2 libdrm2 libxkbcommon0 libxcomposite1 \
    libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 \
    libcairo2 libasound2 libxshmfence1 && \
    rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /out .
ENTRYPOINT ["dotnet", "MyApp.dll"]


using IronPdf;

// Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependencies自动配置 = false;
// No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>");
pdf.SaveAs("output.pdf");
using IronPdf;

// Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependencies自动配置 = false;
// No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>");
pdf.SaveAs("output.pdf");
Imports IronPdf

' Dependencies handled by Dockerfile apt-get — disable runtime install
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False
' No GPU in containers
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Dockerized PDF</h1>")
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

相关入门指南: 如何使用Docker运行IronPDF

5. 将IronPDF与其他.NET PDF库进行比较

IronPDF 凭借其强大的 Chromium 驱动的渲染引擎、直观的 API 和频繁的产品升级,成为许多团队生成 C# PDF 的首选解决方案。 让我们将 IronPDF 与其他 PDF 转换器进行比较,找到最适合您的 PDF 生成需求的产品。

快速决策矩阵:IronPDF 与其他 .NET PDF 转换器的比较

解决方案 何时使用 最适合
IronPDF 以准确的视觉保真度将现代网站/HTML 转换为 PDF。 需要可靠的 HTML 渲染引擎、动态内容和专业支持的企业应用
wkhtmltopdf中文版 在可以接受过时呈现的非关键应用中进行简单的 HTML 转换。 使用传统 HTML/CSS 生成基本文档。
Syncfusion 已在 Syncfusion 生态系统中投资或有资格获得免费社区许可证。 使用多个 Syncfusion 组件的组织。
Aspose.PDF 在对 HTML 呈现质量要求不高的情况下进行复杂的 PDF 操作。 HTML 转换之外的广泛 PDF 编辑功能。

相关比较:

详细比较:IronPDF 与其他 .NET PDF 转换器的比较

特征 ★ 推荐 IronPDF wkhtmltopdf iText Aspose.PDF Syncfusion Apryse SelectPdf Spire.PDF PDFSharp QuestPDF
渲染与转换
渲染精度 像素级完美 印刷风格 仅限程序化 好的 好的 好的 好的 低级别 无需渲染 代码优先布局
HTML5 支持 满的 过时的 添加在 部分的 满的 模块 满的 有限的 否(代码优先)
CSS3 支持 满的 有限的 添加在 部分的 满的 模块 满的 有限的 否(代码优先)
JavaScript 执行 完整 最佳 争议 有限的 有限的 有限的 非常有限
HTML→PDF(现代布局) 嵌入式铬最佳 Qt WebKit(已过时) 付费插件 部分;JS 有争议 闪烁引擎 需要模块 完整 HTML→PDF 基于图像的 不是 HTML 渲染器
PDF→图像渲染 是的 是的 是的 有限的 仅限自有文档
文档操作
通过编程方式生成 PDF 是的 是的 是的 是的 是的 仅HTML 是的 基本的 是的(Fluent API)
合并、拆分和重新排列 是的 是的 是的 是的 是的 是的 是的 有限的 是的
页眉/页脚/页码 HTML/文本/图像最佳 数量有限 通过活动 通过活动 模板 手册 仅限手动 头等舱座位
水印和印章 文字与图像 是的 是的 是的 是的 是的 有限的 是的(叠加层)
从 PDF 中提取文本 是的 是的 是的 是的 是的 是的 是的 基本的
扫描PDF的OCR 通过IronOCR集成 添加在 独立产品 添加在 添加在 解决方法
安全性与合规性
数字签名 是的 是的 是的 是的 示例代码 是的 未记录
PDF/A 合规 是的(PDF/A-3B) 完整版PDF/A 验证并创建 需要原生 SDK PDF合规性 是的 有限的 PDF/A-2x 和 3x
平台与开发者体验
跨平台 Windows · Linux · macOS全部 3 取决于二进制文件 .NET Standard 2.0 Linux额外设置 Blink + .NET服务器 原生 SDK 仅限 Windows 系统 * Linux 文档有限 以 Windows 为中心的 Windows/Linux/macOS
云端和 Docker 部署 Azure · AWS · Docker最佳 复杂;遗产 多包 部分;容器 需要额外的 Blink 组件 本地部门 仅限 Windows 信息有限 简单;轻便 Docker/K8s;本地
支持与文档
文档 广泛 + 复制/粘贴最佳 部分 CLI 文档 广泛的;KB 广泛; GitHub 帮助中心 跨语言目录 入门指南 节目指南 社区指南 结构化 + 配套应用程序
开发人员支持 全天候工程师最佳服务 仅限社区成员 包含订阅 论坛 + 付费 24/5 直达轨道 商业的 电子邮件 论坛 + 电子邮件 仅限社区成员 社区 + GitHub
许可与定价
许可模式 永久 开源 AGPL / 订阅 永久 年度订阅 定制/消费 永久 年度订阅 免费(MIT) 麻省理工学院免费/付费层级
起价 $liteLicense 永久许可 · 1 名开发者 style="color:#16a34a">自由的 ~4.5万美元/年 定制报价 ,175+ 每位开发者 5/年 订阅 · 免费(<100万美元) ~9,000+美元/年 定制报价 9+ 永久许可 9/年 年度订阅 style="color:#16a34a">自由的 style="color:#16a34a">免费 社区 MIT <100万美元
免费试用 30天 · 所有功能无限制 不适用(免费) 30天 是的(带水印) Community <$1M Rev 社区(5 页) 免费(10页) 不适用(免费) N/A (MIT Free <$1M)
定价透明度 已发布和清晰最佳 开源 复合AGPL 多层级 联系我们获取报价 未公布价格 已发布 已发布 麻省理工学院;无限制 麻省理工学院;基于信任

真实环境下的 HTML 转 PDF 比较:渲染 Reddit 主页

为了评估输出 PDF 的质量,我们测试了包含动态网络内容、现代 CSS 和 JavaScript HTML 元素的 Reddit 主页。 该页面是生成输出 PDF 的理想测试案例。

https://www.reddit.com/

Reddit 主页截图,展示了用于 PDF 转换测试的动态内容、现代风格和交互元素

IronPDF

IronPDF 转换结果展示了 Reddit 主页的像素级完美渲染,所有动态内容、样式和交互元素均得以保留

IronPDF 提供像素级精确的结果,保留所有动态网页内容、现代的网页字体样式和交互元素,完全按照 Chrome 中显示,只需要几行代码。

Syncfusion

Syncfusion PDF 转换示例:Reddit 主页部分渲染,存在缺失内容及样式不完整的情况

Syncfusion 渲染的 PDF 大多数内容和样式都缺失,特别是动态内容。 最初被 Reddit 的安全措施阻挡。 要达到更好的结果需要大量命令行调试,然而输出仍然是不完整的。

Aspose.PDF

Aspose.PDF 转换示例:仅捕获极少内容,Reddit 主页上的大部分页面元素缺失

Aspose.PDF 首先需要手动下载 HTML(不支持直接 URL)。 转换后,输出缺乏适当的格式,几乎所有内容部分都缺失,使其不适合处理包含动态内容的现代网页。

wkhtmltopdf

wkhtmltopdf 生成的输出显示了 Reddit 主页的静态、无样式版本,不含动态元素或现代 CSS

wkhtmltopdf 完成速度较快但生成了一个平凡、静态的页面,缺少关键内容如实时更新、动态元素和交互部分。 这展示了 wkhtmltopdf 不适用于现代的、JavaScript 驱动的网站。

性能和输出 PDF 质量的结论

对于需要可靠的 HTML 转 PDF 转换器的 .NET 开发者来说,IronPDF 以最少的代码量、易于使用的 API 和频繁的产品增强而脱颖而出。

在涉及 Web 内容的真实世界测试中,它提供了最快速、最精确的结果,而 Syncfusion 表现落后,Aspose 需要额外步骤,而 wkhtmltopdf 缺失现代样式。 IronPDF 为现代 HTML 转 PDF 转换工作流提供了速度、精确性和简便性的最佳平衡。

请注意: Aspose、Syncfusion和wkhtmltopdf是其各自所有者的商标。 本网站与它们无关且未得到它们的认可。 所有名称、徽标和品牌属于其所有者,并且比较基于撰写时公开可用的信息。

总结

本指南涵盖了在 .NET 中将 HTML 转换为 PDF 所需的一切:从基本字符串转换到异步处理、数字签名和批量生成等高级功能。 我们展示了三种转换方法、基本配置、高级功能和安全设置,并通过动态文档生成的实际测试比较了 IronPDF 和其他库的表现。

而竞争对手在现代网站上表现不佳或者需要复杂的解决办法,IronPDF 的强大渲染引擎以最少的代码量提供了完美的结果。

准备好简化您的 PDF 工作流并在几行代码内体验多功能的 PDF 生成吗? 通过 NuGet 包管理器(或选择在 Visual Studio 中管理 NuGet 包)安装 IronPDF 并立即将您的第一个 HTML 转换为 PDF。

启动您的 30 天免费试用进行无水印的生产测试。 灵活的许可方案起价为 $999,并提供透明的团队定价,可根据您的需求灵活调整。

查看 IronPDF 授权许可

6. 疑难解答与技术支持

处理 HTML 转 PDF 转换中遇到的以下错误有麻烦吗? IronPDF 提供 24/7 工程师支持,可通过 https://ironpdf.com/ 上的聊天小工具获取。

快速解决常见错误

  • 首次渲染慢? 正常。 Chrome 在 2–3 秒内初始化,然后加速。
  • 云问题? 至少使用 Azure B1 或同等资源。
  • 资产丢失? 设置基本路径或嵌入为 base64。
  • 元素丢失? 添加 RenderDelay 以执行 JavaScript 代码。
  • 渲染时的内存问题? 更新到 v2025.9.4 以解决 HTML 转 PDF、戳记和页眉/页脚问题。
  • 表单字段问题(如长文本区、复选框)? 在 v2025.7.17 中已修复; 确保复选框具有唯一名称。
  • 自定义页眉/页脚裁剪或特殊字符损坏? 在 v2025.8.8 中已解决; 测试自动换行和元数据。

从 IronPDF 的工程师团队获得帮助,全天候提供服务

下一步

如何合并或拆分 PDF 文档
查看如何使用
如何在 PDF 文件中添加自定义页眉和页脚
查看如何使用
如何编辑 PDF 中的文本和区域
查看如何使用

常见问题解答

如何用 C# 将 HTML 转换为 PDF?

您可以使用 Chrome 渲染库将 HTML、CSS3 和 JavaScript 转换成像素完美的 PDF,从而用 C# 将 HTML 转换成 PDF。IronPDF 等工具可让您从 URL、HTML 字符串或文件进行渲染,同时支持标题、身份验证和打印设置。

什么是 .NET 的最佳 HTML 转 PDF 库?

最佳的库应支持准确的Chrome渲染、跨平台部署和企业功能。IronPDF涵盖了所有这些功能——在Windows、Linux、macOS和Docker上运行,并支持安全性、签名、合规性和可扩展的.NET应用程序。

如何使用 C# 将 HTML 字符串转换为 PDF?

要将 HTML 字符串转换为 PDF,请使用 ChromePdfRenderer 类及其 RenderHtmlAsPdf 方法。将 HTML 字符串传递给此方法,然后使用 SaveAs 保存 PDF。

在 C# 中将网页 URL 转换为 PDF 文档的步骤是什么?

您可以使用 RenderUrlAsPdf 方法直接将网页 URL 转换为 PDF,这使您可以保留样式、图像和交互元素,如表单和超链接。

如何用 C# 将 HTML 文件转换为 PDF?

使用ChromePdfRenderer.RenderHtmlFileAsPdf("path/to/file.html")将本地HTML文件转换为PDF。IronPDF会自动解析所有相对资源路径(如图片、CSS、JS)。

如何将ASP.NET Razor Pages或MVC Views转换为PDF?

IronPDF提供了专门的扩展包——IronPdf.Extensions.Razor用于Razor Pages,IronPdf.Extensions.Mvc.Core用于MVC Views。使用RenderRazorToPdfRenderRazorViewToPdf与依赖注入结合,从您的控制器直接将视图转换为PDF。参见Razor指南 →

如何确保 PDF 中的 JavaScript 内容被正确渲染?

通过设置RenderingOptions.EnableJavaScript = true启用JavaScript渲染,并使用RenderingOptions.WaitFor.RenderDelay添加渲染延迟,以确保在转换前动态内容完全加载。参见WaitFor指南 →

在 C# 中将标题和页脚添加到 PDF 的最佳方法是什么?

使用TextHeaderFooter类用于简单的文本页眉和页脚,或使用HtmlHeaderFooter类用于更复杂的HTML内容。您可以包含动态占位符,例如{page}{total-pages}{date}用于自动内容生成。参见页眉和页脚指南 →

如何在 C# .NET 中管理 PDF 输出中的分页符?

通过在打印媒体类型的CSS块中使用诸如page-break-after: alwayspage-break-inside: avoid等CSS属性来控制PDF中的分页符。参见分页符指南 →

PDF 设置纸张尺寸和方向有哪些选项?

使用RenderingOptions.PaperSize设置纸张尺寸(选项包括A4、Letter、Legal等)以及用RenderingOptions.PaperOrientation设置方向为纵向或横向。也支持毫米或英寸的自定义尺寸。参见纸张尺寸指南 →

我可否将已认证的网页转换为PDF?

可以。IronPDF支持Cookie、自定义HTTP头以及基于表单的认证。通过ChromePdfRenderer.RenderingOptions.CustomCookies设置Cookie,或传递认证标头以支持基于令牌的认证。同时支持Windows NTLM和Kerberos认证。参见Cookies指南 →

我可以使用 C# 从一个 HTML 模板创建多个 PDF 吗?

是的,创建包含占位符的 HTML 模板,然后使用 like Handlebars.NET 这样的字符串替换或模板库。在循环数据中用实际值替换占位符,并使用 RenderHtmlAsPdf 生成 PDF。

是否可以用密码保护我生成的 PDF?

可以,您可以使用SecuritySettings属性设置用户和所有者密码,配置打印和复制权限,并通过SecuritySettings.EncryptionAlgorithm应用AES256加密。参见加密指南 →

我能否从HTML生成符合PDF/A标准的文档?

可以。IronPDF支持PDF/A-1b、PDF/A-2b、PDF/A-3b和PDF/UA标准,用于存档和可访问性合规,这是大多数HTML到PDF转换器不提供的功能。参见PDF/A指南 →

如何优化生成大量 PDF 的性能?

通过使用异步方法如RenderHtmlAsPdfAsync进行非阻塞操作来优化性能。重用ChromePdfRenderer实例,使用Task.WhenAll同时处理多个PDF,并确保您在64位系统上拥有充足的服务器资源。参见异步指南 →

如何合并多个 PDF 或在我的文档中包含封面?

使用静态PdfDocument.Merge方法合并多个PDF。单独生成您的封面页,然后将其与主文档合并以创建一个综合的PDF。查看合并指南 →

我可以在Azure、AWS或Docker上部署IronPDF吗?

可以。IronPDF可以在Azure App Service、Azure Functions、AWS Lambda和Linux上的Docker容器中运行。每个平台都有专门的设置指南和Docker镜像可用。查看Azure指南 → · 查看AWS指南 → · 查看Docker指南 →

.NET 10 兼容性:IronPDF 是否立即支持 .NET 10?

可以 —— IronPDF完全兼容.NET 10。根据IronPDF的发布说明,该库可立即用于.NET 10项目,无需额外配置。无论您使用的是web、控制台、桌面或微服务应用程序,IronPDF都能与.NET 10开箱即用。

IronPDF 是免费使用的吗?

IronPDF提供30天免费试用,具有完整功能且开发中无水印。生产环境使用需购买商业许可证,起价为$749。提供Lite、Plus、Professional和Enterprise不同等级。查看价格 →

这个库的渲染质量如何与其他选项如wkhtmltopdf相比?

此库使用现代 Chrome 渲染引擎来创建像素完美的 PDF,而 wkhtmltopdf 使用过时的 WebKit 引擎。它不需要服务器可执行文件,支持完整的 JavaScript/CSS3,定期更新并提供专业支持。

为何选择此库而不是 PDFSharp 进行 HTML 转 PDF 转换?

PDFSharp缺乏内置的HTML到PDF转换,需要复杂的解决方案。这个库提供直接的HTML/URL/文件转换,具有高级API,支持现代Web技术,并定期更新,提供专业支持。查看PDFSharp对比 →

为什么这个是比iTextSharp更好的HTML转换选择?

iTextSharp的免费版本不支持本地HTML到PDF转换,且API复杂。这个库提供无缝的HTML转换,具有直观的API,全面支持CSS3/JavaScript,无AGPL许可限制。查看iTextSharp对比 →

此库的渲染质量与 Aspose.PDF 相比如何?

这个库生成像素完美的Chrome质量PDF,而Aspose.PDF通常会丢失样式和动态内容。Aspose需要手动HTML下载进行URL转换,但这个库可以直接转换URL,准确性更高。查看Aspose对比 →

为什么可能选择此库而不是 Syncfusion PDF?

虽然Syncfusion能力出众,这个库的优化Chrome引擎性能更快,处理动态内容更高效。它提供更简单的API和额外功能,如OCR和条形码生成。查看Syncfusion对比 →

Jacob Mellor,Team Iron 的首席技术官
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官,也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者,他从公司成立之初就开始塑造公司的产品架构,与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司,为 NASA、特斯拉和全球政府机构提供服务。

Jacob 拥有曼彻斯特大学土木工程一级荣誉工程学士学位(BEng)(1998-2001 年)。他的旗舰产品 IronPDF 和 Iron Suite for .NET 库在全球的 NuGet 安装量已超过 3000 万次,其基础代码继续为全球使用的开发人员工具提供动力。Jacob 拥有 25 年的商业经验和 41 年的编码专业知识,他一直专注于推动企业级 C#、Java 和 Python PDF 技术的创新,同时指导下一代技术领导者。

审核者
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 下载 19,014,616 | 版本: 2026.5 just released
Still Scrolling Icon

还在滚动吗?

想快速获得证据? PM > Install-Package IronPdf
运行示例看着你的HTML代码变成PDF文件。