1. IronPDF
  2. 教程
  3. .NET Core PDF生成
如何在.NET Core中生成PDF文件

使用 IronPDF 在 .NET Core 中使用 C# 将 HTML 转换为 PDF.

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

直接从 HTML 生成高保真 PDF 是现代 .NET 应用程序中的常规需求——报告、发票和票据都需要与网页用户界面匹配的像素完美输出。 IronPDF 通过公开一个单一的 C# API 来简化此工作流程，将 HTML、Razor 视图和完整网站呈现为符合标准的 PDF 文档。 在本指南结束时，开发人员将能够在 ASP.NET Core 项目中转换 URL、原始 HTML 或 MVC 视图，并将相同的代码部署到 Windows、Linux、Docker 或无服务器环境。

提示对于排版问题，IronPDF 提供了一个无头 Chrome 调试器，可在 PDF 呈现之前帮助诊断 CSS、JavaScript 和媒体查询的异常。 请查阅专门的 pixel-perfect HTML-to-PDF 指南，了解深入的技术。

快速入门：在 .NET Core 中从 HTML 创建 PDF

使用 IronPDF 库轻松将 HTML 转换为 .NET Core 中的 PDF。 本指南提供了一个简单的示例，以最少的代码快速开始，将 HTML 内容呈现到高质量的 PDF 中。 非常适合希望轻松将 PDF 创建集成到其应用程序中的开发人员。

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

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

    PM > Install-Package IronPdf

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

    var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello World</h1>");

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

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

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

  1. 安装 IronPdf NuGet 软件包。
  2. 使用 RenderUrlAsPdf 转换网站 URL
  3. 通过 RenderHtmlAsPdf 渲染原始 HTML
  4. 将 MVC 视图导出为 PDF
  5. 调整纸张大小、页边距、页眉和页脚

快速启动检查表

  1. 安装 – Install-Package IronPdf
  2. 呈现 URL – ChromePdfRenderer.RenderUrlAsPdf()
  3. 呈现原始 HTML – ChromePdfRenderer.RenderHtmlAsPdf()
  4. 导出 Razor 视图 – ChromePdfRenderer.RenderHtmlAsPdfAsync()
  5. 微调输出 – 利用 ChromePdfRenderer.RenderingOptions

本教程涵盖的内容

  • URL、HTML 字符串和 Razor 视图转换
  • 纸张、边距和媒体类型配置
  • 跨平台部署（Windows、Linux、Docker）
  • 后处理：合并、水印、密码保护和数字签名 PDF
  • 端到端样本：票务 MVC 应用程序

如何在 .NET Core 中安装 PDF 库？

在任何 .NET 8项目中安装库只需一行代码，并且与 .NET 9 preview 和即将发布的 .NET 10 版本保持向前兼容。 使用 NuGet 的包管理器控制台，包管理器将自动解析 Windows、Linux、Docker 和无服务器目标的所有依赖项。

PM> Install-Package IronPdf             # .NET 8 LTS and higher
PM> Install-Package IronPdf             # .NET 8 LTS and higher
SHELL

[{i:(需要 CLI 吗？同样的命令可以通过 dotnet add package IronPdf 在您的项目文件夹内运行。

安装完成后，通过转换任何公共网址确认一切正确连接：

// Program.cs — .NET 8 LTS
using IronPdf;

var renderer = new ChromePdfRenderer();

// Render a live website to PDF
using PdfDocument pdf = renderer.RenderUrlAsPdf("https://example.com");

// Persist to disk
pdf.SaveAs("website-snapshot.pdf");
// Program.cs — .NET 8 LTS
using IronPdf;

var renderer = new ChromePdfRenderer();

// Render a live website to PDF
using PdfDocument pdf = renderer.RenderUrlAsPdf("https://example.com");

// Persist to disk
pdf.SaveAs("website-snapshot.pdf");
$vbLabelText   $csharpLabel

其工作原理

  • ChromePdfRenderer 启动一个沙盒化的 Chromium 实例，无需单独安装 Chrome。
  • RenderUrlAsPdf 捕获完整呈现的 DOM，包括 JavaScript 驱动的内容、CSS 媒体查询和字体。
  • 生成的 PdfDocument 提供合并、密码保护或数字签名输出的助手方法——教程后面将介绍这些功能。

有关部署细节（Azure App Service、AWS Lambda、本地 Linux），请参阅专门的 安装指南 和 高级 NuGet 设置 页面。 关于 Docker 和 K8s 集群的内部 CI/CD 提示，请参阅 Docker 部署最佳实践。

.NET Core 服务如何将实时网站网址转换为 PDF？

只需调用 RenderUrlAsPdf：传递任何可公开访问的 URL，IronPDF 即可返回完全呈现、符合标准的 PDF。 下面的代码适用于 .NET 8 LTS，并且在 .NET 9 预览以及计划的 2025 年 .NET 10 版本中无需更改即可编译。

逐步示例

// Program.cs — .NET 8 LTS-compatible
using IronPdf;

// 1. Activate a license (or trial key)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// 2. Create a reusable renderer instance
var renderer = new ChromePdfRenderer
{
    RenderingOptions =
    {
        // Force A4 portrait output and apply @media print styles
        PaperSize    = PdfPaperSize.A4,
        CssMediaType = PdfCssMediaType.Print
    }
};

// 3. Convert Microsoft Docs home page to PDF
using PdfDocument pdf = renderer.RenderUrlAsPdf("https://learn.microsoft.com/");

// 4. Save the PDF or stream it from a Web API
pdf.SaveAs("docs-offline-copy.pdf");
// Program.cs — .NET 8 LTS-compatible
using IronPdf;

// 1. Activate a license (or trial key)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// 2. Create a reusable renderer instance
var renderer = new ChromePdfRenderer
{
    RenderingOptions =
    {
        // Force A4 portrait output and apply @media print styles
        PaperSize    = PdfPaperSize.A4,
        CssMediaType = PdfCssMediaType.Print
    }
};

// 3. Convert Microsoft Docs home page to PDF
using PdfDocument pdf = renderer.RenderUrlAsPdf("https://learn.microsoft.com/");

// 4. Save the PDF or stream it from a Web API
pdf.SaveAs("docs-offline-copy.pdf");
$vbLabelText   $csharpLabel

其工作原理

  • ChromePdfRenderer 启动一个沙盒化的 Chromium 实例，无需系统 Chrome 依赖，从而保持 Docker 镜像精简。
  • RenderUrlAsPdf 在快照前等待 DOM 和 JavaScript 完成，以便单页应用程序正确呈现。
  • 设置 CssMediaType 为 Print 告诉引擎使用特定于打印的规则，匹配浏览器的_打印 → 保存为 PDF_输出。
  • 生成的 PdfDocument 可以加密、数字签名、合并或栅格化——这些功能将在后面的部分介绍。

提示Pixel-perfect 调试：启用 renderer.LoggingOptions.DebugMode = true 并遵循 headless-Chrome 调试指南] 在渲染过程中检查实时 DevTools.

相关资源

如何在 .NET Core 中将原始 HTML 转换为 PDF？

将 HTML 字符串或 Razor 视图的渲染标记传递给 ChromePdfRenderer.RenderHtmlAsPdf 可立即生成符合标准的 PDF。 该方法启动 IronPDF 的嵌入式 Chromium 引擎，因此无需外部浏览器安装或 WebView 依赖。 下面显示的相同代码今天在 .NET 8 LTS 上编译，并与 2025 年 11 月计划发布的 .NET 9 和 .NET 10 版本保持向前兼容。

示例 — 从 HTML 片段生成 PDF

// Program.cs — compatible with .NET 8 and newer
using IronPdf;

// Sample HTML fragment (could also be read from a file, Razor view, or CMS)
const string html = """
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Quarterly Report</title>
  <style>
     body { font-family:'Segoe UI', sans-serif; margin:1.2rem; }
     header { margin-bottom:2rem; }
     h1 { color:#3056d3; }
     table { width:100%; border-collapse:collapse; margin-top:1rem; }
     th,td { border:1px solid #ddd; padding:0.5rem; text-align:right; }
     tr:nth-child(even){ background-color:#f8f9fa; }
  </style>
</head>
<body>
  <header><h1>Q2 Revenue Summary</h1></header>
  <table>
    <thead><tr><th>Product</th><th>Revenue ($)</th></tr></thead>
    <tbody>
      <tr><td>IronPDF for .NET</td><td>1,200,000</td></tr>
      <tr><td>IronOCR for .NET</td><td>890,000</td></tr>
      <tr><td>IronXL for .NET</td><td>610,000</td></tr>
    </tbody>
  </table>
</body>
</html>
""";

// 1. Create a renderer once and reuse it across conversions
var renderer = new ChromePdfRenderer
{
    RenderingOptions =
    {
        PaperSize    = PdfPaperSize.A4,                  // ISO-standard paper size
        PaperOrientation = PdfPaperOrientation.Portrait,
        CssMediaType = PdfCssMediaType.Screen,           // Respect on-screen CSS
        RenderDelay  = 100,                              // Wait 100 ms for JS/animations
        FallbackEncoding = "utf-8"                       // Handle non-ASCII correctly
    }
};

// 2. Render the HTML fragment
using PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// 3. Persist to disk or return via ASP.NET Core FileStreamResult
pdf.SaveAs("q2-report.pdf");
// Program.cs — compatible with .NET 8 and newer
using IronPdf;

// Sample HTML fragment (could also be read from a file, Razor view, or CMS)
const string html = """
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Quarterly Report</title>
  <style>
     body { font-family:'Segoe UI', sans-serif; margin:1.2rem; }
     header { margin-bottom:2rem; }
     h1 { color:#3056d3; }
     table { width:100%; border-collapse:collapse; margin-top:1rem; }
     th,td { border:1px solid #ddd; padding:0.5rem; text-align:right; }
     tr:nth-child(even){ background-color:#f8f9fa; }
  </style>
</head>
<body>
  <header><h1>Q2 Revenue Summary</h1></header>
  <table>
    <thead><tr><th>Product</th><th>Revenue ($)</th></tr></thead>
    <tbody>
      <tr><td>IronPDF for .NET</td><td>1,200,000</td></tr>
      <tr><td>IronOCR for .NET</td><td>890,000</td></tr>
      <tr><td>IronXL for .NET</td><td>610,000</td></tr>
    </tbody>
  </table>
</body>
</html>
""";

// 1. Create a renderer once and reuse it across conversions
var renderer = new ChromePdfRenderer
{
    RenderingOptions =
    {
        PaperSize    = PdfPaperSize.A4,                  // ISO-standard paper size
        PaperOrientation = PdfPaperOrientation.Portrait,
        CssMediaType = PdfCssMediaType.Screen,           // Respect on-screen CSS
        RenderDelay  = 100,                              // Wait 100 ms for JS/animations
        FallbackEncoding = "utf-8"                       // Handle non-ASCII correctly
    }
};

// 2. Render the HTML fragment
using PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// 3. Persist to disk or return via ASP.NET Core FileStreamResult
pdf.SaveAs("q2-report.pdf");
$vbLabelText   $csharpLabel

代码演示了什么

  • 嵌入式 Chromium -- IronPDF 捆绑了 Chromium 引擎，保证 HTML5、CSS3 和 JavaScript 与现代浏览器的兼容性。
  • 单一依赖 -- 一个轻量级 NuGet 安装覆盖 Windows、Linux、Docker 和 Azure/AWS，无需额外的系统库。
  • 渲染选项 -- PaperSize、CssMediaType 和 RenderDelay 反映了浏览器的打印设置，使 PDF 匹配屏幕布局。
  • 面向未来的目标 -- API 界面在 .NET 8、.NET 9 STS 和即将发布的 .NET 10 中是相同的，因此长期维护工作量最小。
  • 后处理钩子--PdfDocument暴露了合并、密码保护和数字签名的助手，本指南稍后将介绍这些内容。

进一步阅读：请参阅逐步的 HTML 字符串到 PDF 教程 和完整 ChromePdfRenderer API 文档。

如何将 ASP .NET Core MVC 视图导出为 PDF？

IronPDF 以与浏览器相同的方式呈现完全处理的 Razor 视图（.cshtml），并将结果流化为 PdfDocument。 以下工作流程保持控制器逻辑清晰，不需要浏览器插件，并且适用于 .NET 8 LTS、.NET 9 preview 和计划的 2025年 11月的 .NET 10 版本。

端到端控制器示例

// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}
// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}
$vbLabelText   $csharpLabel

该代码的说明

  • 无临时文件 -- Razor 视图在内存中呈现，然后直接传递给 RenderHtmlAsPdf，避免了磁盘 I/O 和临时文件夹的竞争条件。
  • 票据大小输出 -- PaperSize = A5 和窄边距使得在家打印的票据紧凑。
  • 一致的打印样式 -- CssMediaType = Print 应用与浏览器使用的相同 @media print CSS 规则。
  • 二进制流 -- pdf.BinaryData 流式传输文档而不触及文件系统； - PaperSize、Margins 和 CssMediaType 反映了浏览器的打印对话框，因此屏幕布局和 PDF 在 Windows、Linux 和 Docker 上保持一致。
  • 可重用渲染器 -- ChromePdfRenderer 每个控制器实例化一次，然后重用，最小化进程生成开销。

<代码>纸张大小,<代码>纸张方向,<代码>适合纸张宽度

<代码>边距,<代码>页眉,<代码>页脚,<代码>水印

如何在渲染前微调纸张尺寸、边距、页眉、水印和安全性？

IronPDF 公开了一个单一的 ChromePdfRenderOptions 对象，可以完全控制输出的各个方面——纸张尺寸、方向、页眉和页脚、JavaScript 时间、水印、加密和数字签名——无需任何额外的浏览器插件。

代码示例 — 同时应用多个选项

为什么这些选项很重要

// AdvancedOptions.cs — .NET 8 compatible
using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure everything in one place
renderer.RenderingOptions = new ChromePdfRenderOptions
{
    // 1. Page layout
    PaperSize        = PdfPaperSize.A4,                     // ISO size
    PaperOrientation = PdfPdfOrientation.Portrait,
    Margins          = new PdfMargins { Top = 20, Bottom = 25, Left = 15, Right = 15 }, // mm

    // 2. Timing & media
    CssMediaType     = PdfCssMediaType.Print,               // Respect @media print
    EnableJavaScript = true,
    RenderDelay      = 200,                                 // Wait 200 ms for animations

    // 3. Headers & footers (HTML gives full design freedom)
    HtmlHeader       = "<header style='font:14px Segoe UI'>Invoice — {{date}}</header>",
    HtmlFooter       = "<footer style='text-align:right;font-size:10px'>Page {{page}} / {{total-pages}}</footer>",

    // 4. Watermark
    Watermark        = new HtmlStamp
    {
        HtmlTemplate = "<div style='font-size:50px;color:#cccccc;opacity:0.3;'>CONFIDENTIAL</div>",
        VerticalAlignment = VerticalAlignment.Center,
        HorizontalAlignment = HorizontalAlignment.Center
    },

    // 5. Security
    SecurityOptions = new PdfSecurityOptions
    {
        OwnerPassword = "StrongOwnerPwd!",
        UserPassword  = "ReadOnly",
        AllowUserPrinting = false,
        AllowUserCopyPasteContent = false
    }
};

// Render any HTML
using PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Advanced Options Demo</h1>");

// Digitally sign with a PFX certificate (optional)
pdf.SignAndStamp("./certs/company.pfx", "Iron Software", "Bangkok", "Approval");

// Save
pdf.SaveAs("advanced-options-demo.pdf");
// AdvancedOptions.cs — .NET 8 compatible
using IronPdf;

var renderer = new ChromePdfRenderer();

// Configure everything in one place
renderer.RenderingOptions = new ChromePdfRenderOptions
{
    // 1. Page layout
    PaperSize        = PdfPaperSize.A4,                     // ISO size
    PaperOrientation = PdfPdfOrientation.Portrait,
    Margins          = new PdfMargins { Top = 20, Bottom = 25, Left = 15, Right = 15 }, // mm

    // 2. Timing & media
    CssMediaType     = PdfCssMediaType.Print,               // Respect @media print
    EnableJavaScript = true,
    RenderDelay      = 200,                                 // Wait 200 ms for animations

    // 3. Headers & footers (HTML gives full design freedom)
    HtmlHeader       = "<header style='font:14px Segoe UI'>Invoice — {{date}}</header>",
    HtmlFooter       = "<footer style='text-align:right;font-size:10px'>Page {{page}} / {{total-pages}}</footer>",

    // 4. Watermark
    Watermark        = new HtmlStamp
    {
        HtmlTemplate = "<div style='font-size:50px;color:#cccccc;opacity:0.3;'>CONFIDENTIAL</div>",
        VerticalAlignment = VerticalAlignment.Center,
        HorizontalAlignment = HorizontalAlignment.Center
    },

    // 5. Security
    SecurityOptions = new PdfSecurityOptions
    {
        OwnerPassword = "StrongOwnerPwd!",
        UserPassword  = "ReadOnly",
        AllowUserPrinting = false,
        AllowUserCopyPasteContent = false
    }
};

// Render any HTML
using PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Advanced Options Demo</h1>");

// Digitally sign with a PFX certificate (optional)
pdf.SignAndStamp("./certs/company.pfx", "Iron Software", "Bangkok", "Approval");

// Save
pdf.SaveAs("advanced-options-demo.pdf");
$vbLabelText   $csharpLabel

为什么这些选项很重要

  • HTML 页眉和页脚支持 Razor 令牌、CSS 和 JavaScript——方便用于动态页码或品牌标识。
  • HtmlStamp 允许单行创建品牌水印，拥有完整的 HTML + CSS 控制。
  • 安全选项启用了 128 位加密、所有者/用户密码和细粒度的权限，无需第三方工具。
  • 安全选项 启用 128 位加密、拥有者/用户密码，并且无须第三方工具提供细粒度权限。
  • 数字签名 直接在代码中添加密码学印章，保持法律真实性和篡改证据。
  • 提取辅助工具如 ExtractAllText 和 ExtractAllImages 在需要分析时反转过程。
id="advRenderAcc">
class="accordion-item"> ## id="layHead">
data-bs-parent="#advRenderAcc">
class="accordion-body">

`PaperSize`，`PaperOrientation`，`Margins`，`CssMediaType`，`RenderDelay`

PaperSize, PaperOrientation, Margins, CssMediaType, RenderDelay.

class="accordion-item"> ## id="headFoot">
data-bs-parent="#advRenderAcc">
class="accordion-body">

`HtmlHeader`，`HtmlFooter`，动态 Razor 占位符，页码令牌

<代码>HtmlHeader、<代码>HtmlFooter、动态 Razor 占位符、页码令牌

class="accordion-item"> ## id="wmHead">
data-bs-parent="#advRenderAcc">
class="accordion-body">

`Watermark`，`HtmlStamp`，不透明度，对齐

<代码>SecurityOptions、<代码>SignAndStamp、所有者/用户密码、证书密封

下一步任务： 合并多个PDF，提取文本和图像，并部署到Docker或无服务器环境。 ## 如何将 PDF 生成代码部署到 Linux 和 Windows 上的 Docker？

IronPDF 作为一个自包含 NuGet 包发行，因此容器化一个 ASP.NET Core（或控制台）应用程序在Windows 和 Linux上都很简单。

IronPDF 作为一个单一的 自包含 NuGet 包 打包，因此在 Windows 和 Linux 上容器化 ASP.NET Core（或控制台）应用非常简单。 关键是将已发布的二进制文件复制到一个精简的运行时镜像中，并且在 Linux 上添加 IronPDF 所需的两个本地库（libnss3 和 libatk1.0-0）。

请注意为什么使用多阶段？SDK镜像（第1阶段）编译项目；

请注意Why multi-stage? SDK 映像（第 1 阶段）编译项目； 由于舍弃了构建工具，最终的运行时映像（第 2 阶段）保持精简--< 120 MB。

####### ---------- stage 1 ----------
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyPdfApp.csproj", "."]
RUN dotnet restore

COPY . .
RUN dotnet publish -c Release -o /app/publish

####### ---------- stage 2 ----------
FROM mcr.microsoft.com/dotnet/aspnet:8.0-jammy
######## Install two native libs required by Chromium
RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0 && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyPdfApp.dll"]

请注意Windows 容器？将第二阶段替换为 mcr.microsoft.com/dotnet/aspnet:8.0-windowsservercore-ltsc2022- 因为捆绑了 Chromium DLL，所以不需要额外的软件包。

  • API 操作内部调用 ChromePdfRenderer.RenderUrlAsPdf，就像在 Section2 中一样。
docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com
docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com
SHELL
  • API 操作在内部调用 ChromePdfRenderer.RenderUrlAsPdf 就像在第 2 节中一样。
  • 内存占用保持在 200 MB 以下，即使在大规模渲染期间也是如此。
    [{t:(故障排除提示：如果容器日志显示 "libnss3.so not found" 错误，请确认 libnss3 和 libatk1.0-0 都存在。

[{t:(故障排除提示：如果容器日志显示"libnss3.so not found"错误，请确认libnss3和libatk1.0-0都存在。 由于 musl C# 库缺乏所需的符号，因此不支持阿尔卑斯图像**。

IronPDF 将每个 PDF（无论是由 IronPDF、Adobe® Acrobat 还是第三方工具生成）视作一级 PdfDocument 对象，可打开、编辑、加密和重新保存而不会损失质量。

IronPDF将每个PDF——无论是由IronPDF、Adobe® Acrobat还是第三方工具生成——视为一个一等的 PdfDocument 对象，可以打开、编辑、加密并重新保存而不会损失质量。 相同的 API 表面现在可在 .NET 8 LTS 上运行，在 .NET 9 预览版和即将发布的 .NET 10 上编译时也不会有任何变化。

为什么这很重要

// ManipulateExistingPdf.cs — .NET 8 LTS compatible
using IronPdf;
using System.Linq;

// Step 1: Open two existing files (password-protected PDFs are supported)
PdfDocument invoice  = PdfDocument.FromFile("invoice.pdf", "ReadOnly");   // open with user pwd
PdfDocument tAndCs   = PdfDocument.FromFile("terms.pdf");                 // no pwd required

// Step 2: Merge them (invoice pages first, then T&Cs)
PdfDocument mergedPdf = PdfDocument.Merge(invoice, tAndCs);               // 1-liner merge

// Step 3: Apply a diagonal CONFIDENTIAL watermark to every page
mergedPdf.ApplyStamp(
    "<div style='font-size:60px;color:#d9534f;opacity:0.2;transform:rotate(-45deg);"
  + "width:100%;text-align:center;'>CONFIDENTIAL</div>",
    verticalAlignment   : VerticalAlignment.Center,
    horizontalAlignment : HorizontalAlignment.Center);

// Step 4: Extract all text and the first image for audit purposes
string fullText = mergedPdf.ExtractAllText();
var    image    = mergedPdf.ExtractAllImages().FirstOrDefault();

// Step 5: Save or stream
mergedPdf.SaveAs("invoice-with-terms.pdf");
// ManipulateExistingPdf.cs — .NET 8 LTS compatible
using IronPdf;
using System.Linq;

// Step 1: Open two existing files (password-protected PDFs are supported)
PdfDocument invoice  = PdfDocument.FromFile("invoice.pdf", "ReadOnly");   // open with user pwd
PdfDocument tAndCs   = PdfDocument.FromFile("terms.pdf");                 // no pwd required

// Step 2: Merge them (invoice pages first, then T&Cs)
PdfDocument mergedPdf = PdfDocument.Merge(invoice, tAndCs);               // 1-liner merge

// Step 3: Apply a diagonal CONFIDENTIAL watermark to every page
mergedPdf.ApplyStamp(
    "<div style='font-size:60px;color:#d9534f;opacity:0.2;transform:rotate(-45deg);"
  + "width:100%;text-align:center;'>CONFIDENTIAL</div>",
    verticalAlignment   : VerticalAlignment.Center,
    horizontalAlignment : HorizontalAlignment.Center);

// Step 4: Extract all text and the first image for audit purposes
string fullText = mergedPdf.ExtractAllText();
var    image    = mergedPdf.ExtractAllImages().FirstOrDefault();

// Step 5: Save or stream
mergedPdf.SaveAs("invoice-with-terms.pdf");
$vbLabelText   $csharpLabel

  • 打开和合并 – PdfDocument.FromFile 加载任何符合标准的 PDF，包括加密文件，而 PdfDocument.Merge 在单次调用中合并任意数量的文档。

  • 水印 – ApplyStamp（别名HtmlStamp）嵌入样式完整的 HTML/CSS 覆盖——徽标、二维码或对角文本——在选定页面上，无需栅格化。
  • 内容提取 – ExtractAllText 和 ExtractAllImages 提取原始 UTF-8 文本或二进制图像流以供下游存档或 AI 管道使用。
  • 数字签名准备 – 同一 PdfDocument 实例可以使用 SignAndStamp 封印，生成与 ISO 32000-2 数字签名要求对齐的 RFC 3161 兼容哈希。
  • 开放标准合规性 – IronPDF 保留了原始 PDF 结构（字体、图层、XMP 元数据），因此输出与 Adobe® Reader 和其他 ISO 32000-1 观看器兼容。
  • 面向未来 – API 避免了互操作程序集和 Win32 GDI 调用，因此代码无需更改即可在 Windows、Linux、Docker 和即将推出的 .NET 10 无服务器 SKU 上运行。
    需要分割、旋转或删除页面吗？请参阅 页面级编辑教程 以获取详细操作。

在 .NET Core 中如何加密和数字签名 PDF？

IronPDF 通过两个步骤保护文档：基于 AES 的加密（用户/所有者密码 + 细粒度的权限）和 X.509 数字签名，它们通过加密哈希封印文档。

铁PDF通过两个步骤保护文档：AES加密（用户/所有者密码 + 细粒度权限）和X.509数字签名，用于用加密散列密封文件。 ### 示例 — 应用 256 位 AES、锁定打印权限并添加可见签名

幕后

// SecureAndSign.cs — .NET 8 LTS compatible
using IronPdf;

// Step 1: Load an existing PDF (or produce one with RenderHtmlAsPdf)
PdfDocument pdf = PdfDocument.FromFile("financial-report.pdf");

// Step 2: Configure AES-256 encryption & permissions
pdf.SecuritySettings = new PdfSecuritySettings
{
    EncryptionAlgorithm   = PdfEncryptionAlgorithm.AES256Bit,
    OwnerPassword         = "IronAdmin!2025",
    UserPassword          = "ReadOnly",
    AllowUserPrinting     = PdfPrintSecurity.Disabled,
    AllowUserCopyPasteContent = false,
    AllowUserAnnotations  = false
};

// Step 3: Digitally sign with a PFX certificate
pdf.SignAndStamp(
    certificatePath : "./certs/ironsoftware.pfx",
    authority       : "Iron Software Ltd.",
    location        : "Chicago, IL",
    reason          : "Final approval"
);

// Step 4: Persist or stream
pdf.SaveAs("financial-report-secured-signed.pdf");
// SecureAndSign.cs — .NET 8 LTS compatible
using IronPdf;

// Step 1: Load an existing PDF (or produce one with RenderHtmlAsPdf)
PdfDocument pdf = PdfDocument.FromFile("financial-report.pdf");

// Step 2: Configure AES-256 encryption & permissions
pdf.SecuritySettings = new PdfSecuritySettings
{
    EncryptionAlgorithm   = PdfEncryptionAlgorithm.AES256Bit,
    OwnerPassword         = "IronAdmin!2025",
    UserPassword          = "ReadOnly",
    AllowUserPrinting     = PdfPrintSecurity.Disabled,
    AllowUserCopyPasteContent = false,
    AllowUserAnnotations  = false
};

// Step 3: Digitally sign with a PFX certificate
pdf.SignAndStamp(
    certificatePath : "./certs/ironsoftware.pfx",
    authority       : "Iron Software Ltd.",
    location        : "Chicago, IL",
    reason          : "Final approval"
);

// Step 4: Persist or stream
pdf.SaveAs("financial-report-secured-signed.pdf");
$vbLabelText   $csharpLabel

  • AES-256 加密 -- IronPDF 用 NIST 认可的 AES 密钥包装负载，阻止未经授权的打开、打印或复制粘贴。

  • 权限的细粒度 -- 属性如 AllowUserPrinting 和 AllowUserFormData 控制每个操作的权限；
  • 权限粒度 -- 属性如 AllowUserPrinting 和 AllowUserFormData 切换每个操作的权限； - 数字签名 -- SignAndStamp 嵌入 RFC 3161 时间戳和证书链，创建 Adobe® Acrobat 和其他 ISO 32000-2 观看器识别的防篡改哈希。
  • 一站式 API -- 加密和签名都修改同一 PdfDocument 实例，避免多次文件传递并保留内部字体、图层和元数据。
    [{t:(故障排除提示：如果Adobe Reader 报告"无效签名"，请确保 PFX 包含受信任的根证书并且 reason/location 字符串是 ASCII 清晰的。）}]

[{t:(故障排除提示：如果 Adobe Reader 报告 "签名无效"，请确保 PFX 包含受信任的根证书，且 reason/location 字符串为 ASCII 清洁字符串。

id="secAcc">
class="accordion-item"> ## id="encHead">
data-bs-parent="#secAcc">
class="accordion-body">

`PdfSecuritySettings` → `OwnerPassword`，`UserPassword`，`EncryptionAlgorithm`，`AllowUserPrinting`

PdfSecuritySettings → OwnerPassword, UserPassword, EncryptionAlgorithm, AllowUserPrinting.

class="accordion-item"> ## id="sigHead">
data-bs-parent="#secAcc">
class="accordion-body">

`PdfDocument.SignAndStamp` — PFX 路径、授权、位置、原因、时间戳

数字签名

PdfDocument.SignAndStamp - PFX 路径、权限、位置、原因、时间戳

深入探索的内部资源

如何优化和扩展.NET Core中的HTML到PDF性能？

IronPDF的Chromium引擎在现代硬件上已经能在 < 1 s内渲染大多数页面，但可以通过 批处理渲染、启用多线程和缩减无头Chrome开销 来增加吞吐量。 ### 1. 在后台线程池中批量渲染

// BatchRender.cs — Thread-safe on .NET 8+
using IronPdf;
using System.Threading.Tasks;

var htmlSources = Directory.GetFiles("./html", "*.html");
var renderer    = new ChromePdfRenderer();                 // reuse 1 instance

Parallel.ForEach(htmlSources, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, file =>
{
    string html = File.ReadAllText(file);
    using PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(Path.ChangeExtension(file, ".pdf"));
});
// BatchRender.cs — Thread-safe on .NET 8+
using IronPdf;
using System.Threading.Tasks;

var htmlSources = Directory.GetFiles("./html", "*.html");
var renderer    = new ChromePdfRenderer();                 // reuse 1 instance

Parallel.ForEach(htmlSources, new ParallelOptions { MaxDegreeOfParallelism = Environment.ProcessorCount }, file =>
{
    string html = File.ReadAllText(file);
    using PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs(Path.ChangeExtension(file, ".pdf"));
});
$vbLabelText   $csharpLabel
  • ChromePdfRenderer 是 线程安全的； - Parallel.ForEach 饱和每个 CPU 核心；
  • Parallel.ForEach 饱和每个CPU核心； 与单线程循环相比，典型服务器的吞吐量提高了 4-6 倍。

    2. 修剪无头 Chrome 启动成本

IronPDF 提供了自己的 Chromium 构建，但每次渲染都需要一定的启动成本。

池化有帮助，Linux 容器 必须包括两个本机库： 缺少任何一个库将"libnss3.so not found"错误在 Docker 日志中出现。

RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0

Missing either library manifests as a libnss3.so not found error in Docker logs.

Recommended Chrome flags (automatically applied by IronPDF) include --disable-gpu and --no-sandbox to reduce memory and root-user issues in containers.

3. 使用RenderDelay或WaitFor等待延迟的JavaScript

页面在DOMContentLoaded之后执行计数动画或获取数据可能需要短暂延迟：

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";
renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";
$vbLabelText   $csharpLabel

查看专门的WaitFor教程以获取自定义承诺和DOM检查。

4. 启用一次请求的调试日志记录

renderer.LoggingOptions.DebugMode        = true;
renderer.LoggingOptions.LogsToConsole    = true;
renderer.LoggingOptions.LogFilePath      = "./logs/ironpdf-debug.log";
renderer.LoggingOptions.DebugMode        = true;
renderer.LoggingOptions.LogsToConsole    = true;
renderer.LoggingOptions.LogFilePath      = "./logs/ironpdf-debug.log";
$vbLabelText   $csharpLabel

实时DevTools跟踪可以揭示丢失的字体、404图片和不重新编译代码的计时事件。

5. 重用模板PDF而不是重新渲染

对于发票运行，创建带有占位符的模板PDF如[[name]]，并执行文本替换而不是重建复杂的HTML。 它速度快10倍且内存轻。

快速调整清单

Parallel.ForEach、async/await、重复使用单个ChromePdfRenderer。

进一步阅读

我在哪里可以下载免费试用版、选择许可证并获取专家支持？ {#anchor-10-resources}

一个30天试用密钥可以立即从开始免费试用表单中获取，并解锁所有功能——包括HTML到PDF、数字签名和加密——没有水印。

评估库后，选择永久的开发者、部署或企业许可证； 每个计划都包括免费的小更新、开发/暂存/生产使用权和30天退款保证。 应用密钥是单行代码(IronPdf.License.LicenseKey = "YOUR-KEY";)，可以在CI/CD管道中自动化。

全面的文档——快速入门指南、API参考和教程视频——位于文档门户，每个.NET发布均更新。

工程问题通过实时聊天、电子邮件或电话从芝加哥的支持团队一天内得到回应。

性能调整和部署常见问题汇总在性能协助中心。

快捷链接

资源网址重要性
获取30天试用密钥https://ironpdf.com/demos/解锁所有功能没有水印
许可和定价https://ironpdf.com/licensing/永久或订阅计划； Iron Suite捆绑10个库
API参考https://ironpdf.com/object-reference/api/完整的类文档，例如ChromePdfRenderer
文档门户https://ironpdf.com/docs/指南、教程、示例项目
性能协助https://ironpdf.com/troubleshooting/ironpdf-performance-assistance/优化和扩展提示
联系支持https://ironsoftware.com/contact-us/即时聊天、电子邮件、电话支持

下一步

  1. 克隆示例仓库，展示所有主要功能——从MVC视图渲染到AES-256加密。
  2. 将试用密钥插入现有解决方案，运行单元测试以验证跨平台兼容性。
  3. 预约现场演示与工程团队一起为项目特定的建议。

通过这些资源，任何.NET团队在一个单一的冲刺中都可以将像素完美的PDF投入生产——无论是在本地、Docker中还是无服务器。

常见问题解答

如何在 .NET Core 中将 HTML 转换为 PDF？

您可以使用 IronPDF 库在 .NET Core 中将 HTML 转换为 PDF。首先，安装 IronPDF NuGet 包，然后创建一个 ChromePdfRenderer 实例。使用 RenderHtmlAsPdf 方法将 HTML 字符串转换为 PDF。

如何将网站 URL 转换为 PDF 文档？

要将网站 URL 转换为 PDF 文档，请安装 IronPDF NuGet 包，创建一个 ChromePdfRenderer 实例，并使用 RenderUrlAsPdf 方法将 URL 渲染为 PDF。可以使用 SaveAs 方法保存结果。

将 Razor 视图转换为 PDF 的最佳方式是什么？

将 Razor 视图转换为 PDF 的最佳方式是使用 IronPDF。首先，将 Razor 视图渲染为 HTML 字符串，然后将此字符串传递给 RenderHtmlAsPdf 方法以创建 PDF 文档。

如何增强我的 PDF 文档的安全性？

通过使用 IronPDF 增强 PDF 安全性，可以应用 AES-256 加密、设置密码和控制用户权限。通过 SecuritySettings 属性配置这些设置，以限制诸如打印和编辑等操作。

有哪些自定义 PDF 渲染的选项？

IronPDF 提供了多种渲染选项，通过 ChromePdfRenderOptions 类，包括设置纸张大小、方向、边距和应用 CSS 媒体类型。您还可以添加页眉、页脚和水印以实现定制的文档输出。

如何在 Docker 容器中部署 PDF 生成应用程序？

要在 Docker 容器中部署 PDF 生成应用程序，请在 Dockerfile 中配置 Linux 依赖项并设置用户权限。利用 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 进行自动依赖项管理。

如何使用 C# 为 PDF 添加水印？

您可以通过使用 Watermark 属性和 HtmlStamp 对象在 PDF 中添加水印。对于高级选项，HtmlStamper 类允许自定义定位和透明效果。

我可以为 PDF 文档添加数字签名吗？

是的，您可以使用 IronPDF 的 PdfSignature 类为 PDF 添加数字签名。对 PdfDocument 使用 Sign 方法，并提供一个证书文件以确保文档的完整性和真实性。

如何优化 .NET Core 中 PDF 生成的性能？

通过重用一个线程安全的 ChromePdfRenderer 实例、启用多线程，并去除不必要的无头 Chrome 启动标志来优化 PDF 生成性能。这些实践有助于提高应用程序的效率。

本教程中的 .NET Core HTML 转 PDF 示例是否也适用于 .NET 10？

是的。IronPDF 完全兼容 .NET 10，因此您可以在 .NET 10 项目中使用本教程中的 ChromePdfRenderer HTML 转 PDF 示例，而无需更改核心代码。主要区别在于在创建项目时针对 .NET 10，然后从 NuGet 安装最新的 IronPdf 包，以从 HTML、Razor 视图或 URL 生成像素完美的 PDF。

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
  立即与工程团队聊天
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官，是 C# PDF 技术的先锋工程师。作为 Iron Software 核心代码库的原始开发者，自公司成立以来，他就塑造了公司的产品架构，并与首席执行官 Cameron Rimington 一起将其转变成一家公司，拥有50多人，服务于 NASA、特斯拉和全球政府机构。

Jacob 拥有曼彻斯特大学 (1998-2001) 的一级荣誉土木工程学士学位。1999 年在伦敦创办了自己的第一家软件公司，并于 2005 年创建了他的第一个 .NET 组件后，他专注于解决微软生态系统中的复杂问题。

他的旗舰 IronPDF 和 Iron Suite .NET 库在全球已获得超过 3000 万次的 NuGet 安装，其基础代码继续为全球使用的开发者工具提供支持。拥有 25 年商业经验和 41 年编程经验的 Jacob 仍专注于推动企业级 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 下载 17,012,929 | 版本: 2025.12 刚刚发布