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 只需几行代码就能处理复杂的问题。

RELATED: IronPDF Changelog: Updates, milestones, roadmap

您将学到什么

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 文档的操作:

多功能 PDF 转换 动态网页到 PDF 的转换

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

最基本的操作是将 HTML 字符串转换为 PDF。 这种方法非常适合动态生成的 HTML 内容。 RenderHtmlAsPdf 方法在直接将 HTML 转换为 PDF 时完全支持 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

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

当您的 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 字符串中的所有相对路径都将从此目录解析。

RELATED HOW-TO ARTICLE: How to Convert HTML String to PDF in C#

如何将现有 URL 导出到 PDF.

使用 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

RELATED HOW-TO ARTICLE: How to Render URL to 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

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

RELATED HOW-TO Article: Render HTML File to PDF

如何将Razor页面转换为PDF

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

PM > Install-Package IronPdf.Extensions.Razor
PM > Install-Package IronPdf.Extensions.Razor
SHELL
using IronPDF;

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;

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

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")
$vbLabelText   $csharpLabel

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

RELATED HOW-TO Article: How to Convert CSHTML to PDF in Razor Pages

如何将MVC视图转换为PDF

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

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

PM > Install-Package IronPdf.Extensions.Mvc.Core
PM > Install-Package IronPdf.Extensions.Mvc.Core
SHELL

首先,在 Program.cs 文件中注册 IRazorViewRenderer 服务,以便控制器可以注入它:

using IronPdf.Extensions.Mvc.Core;

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.Core;

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.Core;

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.Core;

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

Dim renderer As 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")
$vbLabelText   $csharpLabel

RELATED HOW-TO Article: How to Convert Views to PDF in ASP.NET Core MVC

2.如何配置 HTML 转 PDF 设置

在操作 PDF 文档方面, IronPDF通过 ChromePdfRenderer.RenderingOptions 属性为渲染的 PDF 提供广泛的自定义功能。

设置 描述 示例
纸张大小 为现有 PDF 文件设置页面尺寸(A4、Letter、Legal 等) `PdfPaperSize.A4`
文件方向 为现有 PDF 设置纵向或横向 `PdfPaperOrientation.Landscape`
边距上/下/左/右 以毫米为单位设置页边距(默认值:25 毫米)
Css媒体类型 将 CSS 从 HTML 转换为 PDF 的屏幕或打印 `PdfCssMediaType.Print`
打印 HTML 背景 包含背景颜色/图像(默认值: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 = renderer.RenderHtmlAsPdf(htmlContent)
pdfDocument.SaveAs("styled-output.pdf")
$vbLabelText   $csharpLabel

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

相关 "如何做 "文章:

定制 PDF 转换 优化 PDF 布局

如何设置自定义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.company.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.company.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.company.com/quarterly-report")
pdf.SaveAs("quarterly-report.pdf")
$vbLabelText   $csharpLabel

相关 "如何做 "文章: Render PDFs Behind Login Authentication | Custom HTTP Request Headers

如何配置代理以进行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.corp.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.corp.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.corp.local:8080"
)
pdf.SaveAs("proxied-report.pdf")
$vbLabelText   $csharpLabel

请注意,RenderUrlAsPdf() 不接受代理参数。 要通过代理渲染实时 URL,首先使用配置了 WebProxyHttpClient 获取 HTML,然后将其传递给 RenderHtmlAsPdf(),并使用代理参数加载资源。

RELATED HOW-TO Article: How to Configure Proxy Servers for PDF Rendering

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");
}
// 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");
}
' 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-Package Handlebars.NET
# First, install Handlebars.NET for HTML to PDF templating
PM > Install-Package 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.Compile(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.Compile(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

RELATED HOW-TO ARTICLE: Learn more about Handlebars.NET on GitHub

控制 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.Threading.Tasks;

// 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.Threading.Tasks;

// 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.Threading.Tasks

' 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
$vbLabelText   $csharpLabel

提示HTML 转 PDF 性能优化技巧

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

RELATED HOW-TO Article: How to Generate PDFs with Async and Multithreading

如何添加高级安全功能

如何在 .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

RELATED HOW-TO Article: Digitally Signing PDF Documents with C#

如何将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 = 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中导致字段共享相同的值,会导致用户填写表单时出现意外行为。)}]

RELATED HOW-TO Article: How to Create Fillable PDF Forms in C#

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

要呈现页面的特定部分而不是整个文档,请在渲染之前隔离目标元素。 最直接的方法是使用 JavaScript 渲染选项将文档主体替换为目标元素的内容,并结合 WaitFor.HtmlQuerySelector() 来确保元素在提取之前存在。 下面的代码片段保留了 document.head,以便样式表和字体能够保留下来——如果没有这一步,依赖于祖先选择器的 CSS 规则将在提取的 PDF 中丢失。

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

using IronPDF;

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;

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

Dim 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)

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

RELATED HOW-TO Article: How to Convert HTML Elements and Partial Pages to 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.company.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.company.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.company.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 字典以渲染受保护的页面。

RELATED HOW-TO Article: How to Convert HTML Behind Login Authentication to PDF

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

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

平台 最小资源 自动配置 临时路径 关键问题
Azure应用服务 B1层(基本) IronPDF true /tmp 免费/共享层失败——无GPU,内存低
Azure Functions(Windows) B1层 IronPDF true /tmp 取消选中"从包文件运行"
AWS Lambda 512 MB / 330s超时 IronPDF true /tmp(必需) 默认文件系统是只读的
Docker(Ubuntu/Debian) 取决于镜像 IronPDF 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(基本)层或更高以避免内存不足错误和进程超时。)}]

RELATED GET-STARTED Guide: How to Deploy IronPDF on Azure

如何在AWS Lambda上部署

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

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

using Amazon.Lambda.Core;
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.Core;
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.LinuxAndDockerDependencies自动配置 = 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的渲染占用大量内存,冷启动需要额外的初始化时间来初始化嵌入的浏览器引擎。)}]

RELATED GET-STARTED Guide: How to Deploy IronPDF on AWS Lambda

如何使用Docker部署

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

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

平台 关键配置
Ubuntu 22.04 / Debian IronPDF 默认——开箱即用
Alpine Linux IronPDF 在Dockerfile中通过apk安装chromium
Amazon Linux 2 IronPDF 使用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

RELATED GET-STARTED Guide: How to Use IronPDF with Docker

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 7 Aspose.PDF Syncfusion Apryse SelectPdf Spire.PDF PDFsharp QuestPDF
Rendering & Conversion
渲染精度 像素级完美 印刷风格 仅限程序化 好的 好的 好的 好的 低级别 无需渲染 代码优先布局
HTML5 支持 满的 过时的 添加在 部分的 满的 模块 满的 有限的 否(代码优先)
CSS3 支持 满的 有限的 添加在 部分的 满的 模块 满的 有限的 否(代码优先)
JavaScript 执行 最佳 争议 有限的 有限的 有限的 非常有限
HTML→PDF(现代布局) 嵌入式铬最佳 Qt WebKit(已过时) 付费插件 部分;JS 有争议 闪烁引擎 需要模块 完整 HTML→PDF 基于图像的 不是 HTML 渲染器
PDF→图像渲染 是的 独立模块 独立产品 是的 是的 有限的 仅限自有文档
文档操作
通过编程方式生成 PDF 是的 是的 是的 是的 是的 仅HTML 是的 基本的 是的(Fluent API)
Merge, Split & Rearrange 是的 是的 是的 是的 是的 是的 是的 有限的 是的
页眉/页脚/页码 HTML/文本/图像最佳 数量有限 通过活动 通过活动 模板 手册 仅限手动 头等舱座位
Watermarks & Stamping 文字与图像 是的 是的 是的 是的 是的 有限的 是的(叠加层)
从 PDF 中提取文本 是的 是的 是的 是的 是的 是的 是的 基本的
扫描PDF的OCR 通过IronOCR集成 添加在 独立产品 添加在 添加在 解决方法
Security & Compliance
数字签名 是的 是的 是的 是的 示例代码 是的 未记录
PDF/A 合规 是的(PDF/A-3B) 完整版PDF/A 验证并创建 需要原生 SDK PDF合规性 是的 有限的 PDF/A-2x 和 3x
平台 & Developer Experience
跨平台 Windows · Linux · macOS全部 3 取决于二进制文件 .NET Standard 2.0 Linux额外设置 Blink + .NET服务器 原生 SDK 仅限 Windows 系统 * Linux 文档有限 以 Windows 为中心的 Windows/Linux/macOS
Cloud & Docker Deploy Azure · AWS · Docker最佳 复杂;遗产 多包 部分;容器 需要额外的 Blink 组件 本地部门 仅限 Windows 信息有限 简单;轻便 Docker/K8s;本地
Support & 文档
文档 广泛 + 复制/粘贴最佳 部分 CLI 文档 广泛的;KB 广泛; GitHub 帮助中心 跨语言目录 入门指南 节目指南 社区指南 结构化 + 配套应用程序
开发人员支持 全天候工程师最佳服务 仅限社区成员 包含订阅 论坛 + 付费 24/5 直达轨道 商业的 电子邮件 论坛 + 电子邮件 仅限社区成员 社区 + GitHub
Licensing & Pricing
许可模式 永久 开源 AGPL / 订阅 永久 年度订阅 定制/消费 永久 年度订阅 免费(MIT) 麻省理工学院免费/付费层级
起价 799 美元永久授权 · 1 位开发者 style="color:#16a34a">自由的 年均约 4.5 万美元定制报价 每位开发商1,175 美元以上 订阅费995 美元/年· 100 万美元以下免费 每年约 9000 美元以上的定制报价 499美元+永久 年度订阅费999 美元/年 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 天免费试用进行无水印的生产测试。 灵活的许可方案起价为 $799,透明的团队定价可根据您的需求进行扩展。

查看 IronPDF 授权许可

6. 疑难解答与技术支持

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

快速解决常见错误

  • 首次渲染慢? 正常。 Chrome 在 2–3 秒内初始化,然后加速。
  • 云问题? 至少使用 Azure B1 或同等资源。
  • 资产丢失? 设置基本路径或嵌入为 base64。
  • 元素丢失? 为 JavaScript 执行添加 RenderDelay。
  • 渲染时的内存问题? 更新到 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 下载 18,332,619 | 版本: 2026.4 刚刚发布
Still Scrolling Icon

还在滚动吗?

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