迁移指南

如何在 C# 中从 PDFPrinting.NET 迁移到 IronPDF for .NET

已发布:2026年2月1日

从 PDFPrinting.NET 迁移到IronPDF可将您的 PDF 功能从仅用于打印的库扩展到可处理整个 PDF 生命周期（包括创建、操作、提取、安全和打印）的综合解决方案。本指南提供了完整的分步迁移路径，在保留现有打印工作流程的同时，增加了 PDF 生成、HTML 转换和跨平台支持功能。

为什么要从 PDFPrinting.NET 迁移到 IronPDF?

了解 PDFPrinting.NET.

PDFPrinting.NET 是一种专业的解决方案，在无声 PDF 打印方面具有无与伦比的简便性和有效性。 PDFPrinting.NET 主要在 Windows 生态系统中运行，是专门为需要将 PDF 打印功能集成到其应用程序中的开发人员设计的商业库。作为一款专用工具，PDFPrinting.NET 只专注于无声、稳健地打印 PDF，它在简化通常复杂的任务方面找到了自己的定位，即无需用户干预即可通过编程打印文档。

PDFPrinting.NET 的最大优势之一是能够静音打印文档。它绕过了通常的打印对话窗口，促进了完全自动化的工作流程，这对于要求尽量减少用户交互的应用程序来说至关重要。

仅限打印的限制

PDFPrinting.NET 的一个明显局限是它只涉及 PDF 处理的打印方面。它不能创建、修改或操作 PDF 文档，这限制了它对需要完整 PDF 文档生命周期解决方案的开发人员的实用性：

1.仅打印：不能创建、编辑或操作 PDF 文档。

2.仅限 Windows：与 Windows 打印基础架构绑定——不支持 Linux/macOS。对 Windows 打印基础架构的依赖限制了它在 Windows 环境中的适用性，从而限制了跨平台的可用性。

3.无法生成 PDF：无法将 HTML、URL 或数据转换为 PDF。

4.不支持文档操作：无法合并、拆分、添加水印或保护 PDF 文件。

5.无法提取文本：无法读取或提取 PDF 中的内容。

6.不支持表单处理：无法填写或展平 PDF 表单。

PDFPrinting.NET 与IronPDF的比较

特征	PDFPrinting.NET	IronPDF
主要功能	静音 PDF 打印	全周期处理（创建、编辑、打印）
平台支持	仅限 Windows	跨平台
PDF 创建/操纵功能	否	是
HTML-PDF 转换	否	是
自动化工作流程的适用性	高的	高的
附加依赖项	依赖于 Windows 打印机	用于渲染的内部浏览器引擎
静音打印	是	是
文本提取	不支持	全面支持
许可	商业翻译	商业翻译

IronPDF 通过处理 PDF 的整个生命周期，提供了一个更全面的解决方案。该工具便于创建、编辑、转换和打印 PDF 文档，通过统一的 API 为开发人员提供全套功能。与 PDFPrinting.NET 不同，IronPDF 可在不同平台上部署，因此是在不同环境中运行的应用程序的多功能选择。

对于计划在 2025 年和 2026 年之前采用 .NET 10 和 C# 14 的团队，IronPDF 提供了一个完整的 PDF 解决方案，可在 Windows、Linux 和 macOS 环境中运行。

开始之前

前提条件

.NET 环境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet 访问权限：能够安装 NuGet 包
IronPDF 许可证：请从ironpdf.com获取您的许可证密钥。

NuGet 软件包变更

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

# Remove PDFPrinting.NET
dotnet remove package PDFPrinting.NET

# Install IronPDF
dotnet add package IronPdf

SHELL

许可配置

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

$vbLabelText $csharpLabel

识别 PDFPrinting.NET 的用法

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

# Find PDFPrinting.NET usage
grep -r "PDFPrinting\|PDFPrinter" --include="*.cs" .

# Find print-related code
grep -r "\.Print(\|PrinterName\|GetPrintDocument" --include="*.cs" .

SHELL

完整的 API 参考

命名空间变更

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Printing;

// Before: PDFPrinting.NET
using PDFPrinting.NET;
using PDFPrintingNET;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Printing;

$vbLabelText $csharpLabel

核心类映射

PDFPrinting.NET	IronPDF	备注
`PDFPrinter`	`PDF 文档`	PDF 核心对象
`HtmlToPdfConverter`	`ChromePdfRenderer`	生成 PDF
`WebPageToPdfConverter`	`ChromePdfRenderer`	URL 转换
打印设置属性	`打印设置`	打印配置

打印方法映射

PDFPrinting.NET	IronPDF	备注
`printer.Print(filePath)`	`pdf.Print()`	打印到默认打印机
`printer.Print(path, printerName)`	`pdf.Print(打印机名称)`	打印到特定打印机
`printer.PrinterName = "..."`	`pdf.Print("...")`	指定打印机
`printer.GetPrintDocument(path)`	`pdf.GetPrintDocument()`	获取 PrintDocument
`printer.Copies = n`	`printSettings.NumberOfCopies = n`	稿件数量
`printer.Duplex = true`	`printSettings.DuplexMode = Duplex.Vertical`	双面打印
`printer.CollatePages = true`	`printSettings.Collate = true`	整理

PDFPrinting.NET 中不提供的新功能

IronPdf 特点	说明
`renderer.RenderHtmlAsPdf(html)`	HTML 到 PDF 的转换
`renderer.RenderUrlAsPdf(url)`	URL 到 PDF 的转换
`PdfDocument.Merge(pdfs)`	合并多个 PDF
`pdf.ApplyWatermark(html)`	添加水印
`pdf.SecuritySettings.UserPassword`	密码保护
`pdf.ExtractAllText()`	文本提取

代码迁移示例

示例 1：HTML 到 PDF 的转换

之前（PDFPrinting.NET）：

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

$vbLabelText $csharpLabel

PDFPrinting.NET 使用HtmlToPdfConverter和 ConvertHtmlToPdf(html, outputPath) 将渲染和保存合并在一次调用中。IronPDF使用ChromePdfRenderer和 RenderHtmlAsPdf() 返回一个PDF 文档对象，然后您可以使用 SaveAs() 保存该对象。这种分离提供了更大的灵活性--您可以在保存之前对 PDF 进行处理（添加水印、与其他文档合并、添加安全性）。

IronPDF 提供 HTML 到 PDF 转换等功能，允许开发人员将网页内容呈现为 PDF--充分利用现代网络技术创建文档。通过在内部利用浏览器引擎，IronPDF 可以准确地将网页文档的样式和渲染复制到 PDF 中。请参阅 HTML 转 PDF 文档，了解全面的示例。

示例 2：URL 到 PDF 的转换

之前（PDFPrinting.NET）：

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new WebPageToPdfConverter();
        string url = "https://www.example.com";
        converter.Convert(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}

$vbLabelText $csharpLabel

PDFPrinting.NET 使用WebPageToPdfConverter和 Convert(url, outputPath) 。IronPDF使用与 RenderUrlAsPdf() 方法相同的ChromePdfRenderer类。请注意，IronPDF 对 HTML 字符串和 URL 均使用一个渲染器类，当您需要这两种功能时，可以简化您的代码。在我们的教程中了解更多信息。

示例 3：页眉和页脚

之前（PDFPrinting.NET）：

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

// NuGet: Install-Package PDFPrinting.NET
using PDFPrinting.NET;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.HeaderText = "Company Report";
        converter.FooterText = "Page {page} of {total}";
        string html = "<html><body><h1>Document Content</h1></body></html>";
        converter.ConvertHtmlToPdf(html, "report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Company Report</div>"
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
        };
        string html = "<html><body><h1>Document Content</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("report.pdf");
        Console.WriteLine("PDF with headers/footers created");
    }
}

$vbLabelText $csharpLabel

PDFPrinting.NET 使用简单的字符串属性 HeaderText 和 FooterText 以及占位符 {page} 和 {total} 。IronPDF使用带有 HtmlFragment 属性的 HtmlHeaderFooter 对象，该属性可接受完整的 HTML，允许使用 CSS 进行丰富的样式设计。请注意占位符语法的变化：PDFPrinting.NET 使用 {total} 而IronPDFfor .NET 使用 {total-pages}.

关键迁移说明

替换语法

不同库的页眉/页脚占位符有所不同：

// PDFPrinting.NET placeholders
"Page {page} of {total}"

//IronPDFplaceholders
"Page {page} of {total-pages}"

// PDFPrinting.NET placeholders
"Page {page} of {total}"

//IronPDFplaceholders
"Page {page} of {total-pages}"

$vbLabelText $csharpLabel

加载然后打印模式

PDFPrinting.NET 可直接传递文件路径； IronPdf 优先加载：

// PDFPrinting.NET: Direct path to Print()
printer.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

// PDFPrinting.NET: Direct path to Print()
printer.Print("document.pdf");

// IronPDF: Load first, then operate
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Print();

$vbLabelText $csharpLabel

打印设置迁移

PDFPrinting.NET 使用属性； IronPdf 使用一个设置对象：

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

// PDFPrinting.NET: Properties on printer object
printer.Copies = 2;
printer.Duplex = true;

// IronPDF: Settings object
var settings = new PrintSettings
{
    NumberOfCopies = 2,
    DuplexMode = System.Drawing.Printing.Duplex.Vertical
};
pdf.Print(settings);

$vbLabelText $csharpLabel

HTML 标题与文本标题

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF:完整的 HTMLwith styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

// PDFPrinting.NET: Simple text
converter.HeaderText = "Company Report";

// IronPDF:完整的 HTMLwith styling
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};

$vbLabelText $csharpLabel

迁移后的新功能

迁移到IronPDF后，您将获得 PDFPrinting.NET 无法提供的功能：

PDF 合并

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

$vbLabelText $csharpLabel

水印

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

$vbLabelText $csharpLabel

密码保护

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

$vbLabelText $csharpLabel

文本提取

string text = pdf.ExtractAllText();

string text = pdf.ExtractAllText();

$vbLabelText $csharpLabel

生成然后打印工作流程

使用 IronPDF，您可以在一个工作流程中生成 PDF 并打印：

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1>");
pdf.Print("Invoice Printer");

$vbLabelText $csharpLabel

跨平台打印

PDFPrinting.NET 仅适用于 Windows。 IronPdf 可跨平台运行：

Windows

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

$vbLabelText $csharpLabel

Linux

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

// Requires CUPS (Common Unix Printing System)
// Install: apt-get install cups
pdf.Print("HP_LaserJet");  // CUPS uses underscores instead of spaces

$vbLabelText $csharpLabel

macOS

pdf.Print("HP LaserJet");

pdf.Print("HP LaserJet");

$vbLabelText $csharpLabel

功能对比摘要

特征	PDFPrinting.NET	IronPDF
无声印刷	✓	✓
打印设置	✓	✓
HTML 至 PDF	✗	✓
URL 至 PDF	✗	✓
页眉/页脚	基本的	完整的 HTML
合并 PDF	✗	✓
拆分 PDF	✗	✓
水印	✗	✓
文本提取	✗	✓
密码保护	✗	✓
跨平台	✗	✓

迁移清单

迁移前

清点代码库中所有 PDFPrinting.NET 的使用情况
记录当前使用的所有打印机名称
请注意所有打印设置配置
确定是否需要跨平台支持
规划IronPDF许可证密钥存储（建议使用环境变量）
先使用IronPDF试用许可证进行测试

软件包变更

删除PDFPrinting.NET NuGet 包安装IronPdf NuGet 包： dotnet add package IronPdf

代码更改

更新命名空间导入
将HtmlToPdfConverter替换为ChromePdfRenderer
将WebPageToPdfConverter替换为ChromePdfRenderer
将ConvertHtmlToPdf(html, path)替换为RenderHtmlAsPdf(html).SaveAs(path)
将Convert(url, path)替换为RenderUrlAsPdf(url).SaveAs(path)
将页眉/页脚从HeaderText / FooterText更新为HtmlHeader / HtmlFooter
更新占位符语法（ {total} → {total-pages} ）
将打印调用转换为先加载后打印模式
将打印设置更新到PrintSettings对象

后迁移

在所有目标平台上进行测试打印
验证页眉/页脚渲染效果
考虑为动态文档添加 PDF 生成功能
根据需要添加新功能（合并、水印、安全）

Curtis Chau

立即与工程团队聊天

技术作家

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

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

已发布2026年2月1日

如何用 C# 从 ZetPDF 迁移到 IronPDF

通过这本完整的 C# 指南，掌握从 ZetPDF 到 IronPDF 的迁移。从基于坐标的库转换到现代的 HTML 到 PDF 解决方案。包括 HTML 转换、合并 PDF 和移除 PDFSharp 依赖性的代码示例。

已发布2026年2月1日

如何用 C# 从 Scryber.Core 迁移到 IronPDF

通过这本完整的 C# 指南，掌握从 Scryber.Core 迁移到 IronPDF 的方法。从自定义 XML/HTML 解析转换到现代 Chromium 渲染器。包括 HTML 转换、URL 呈现和替换专有绑定的代码示例。

已发布2026年2月1日

如何用 C# 从 XFINIUM.PDF 迁移到 IronPDF

通过这本完整的 C# 指南，掌握从 XFINIUM.PDF 到 IronPDF 的迁移。从基于坐标的手动定位切换到声明式 HTML/CSS 渲染。包括替换图形基元和自动布局的代码示例。

如何用 C# 从 PDFreactor 迁移到 IronPDF

如何用 C# 从 PdfPig 迁移到 I...

立即开始30天免费试用

如何在 C# 中从 PDFPrinting.NET 迁移到 IronPDF for .NET

为什么要从 PDFPrinting.NET 迁移到 IronPDF?

了解 PDFPrinting.NET.

仅限打印的限制

PDFPrinting.NET 与IronPDF的比较

开始之前

前提条件

NuGet 软件包变更

许可配置

识别 PDFPrinting.NET 的用法

完整的 API 参考

命名空间变更

核心类映射

打印方法映射

PDFPrinting.NET 中不提供的新功能

代码迁移示例

示例 1：HTML 到 PDF 的转换

示例 2：URL 到 PDF 的转换

示例 3：页眉和页脚

关键迁移说明

替换语法

加载然后打印模式

打印设置迁移

HTML 标题与文本标题

迁移后的新功能

PDF 合并

水印

密码保护

文本提取

生成然后打印工作流程

跨平台打印

Windows

Linux

macOS

功能对比摘要

迁移清单

迁移前

软件包变更

代码更改

后迁移

相关文章

如何用 C# 从 ZetPDF 迁移到 IronPDF

如何用 C# 从 Scryber.Core 迁移到 IronPDF

如何用 C# 从 XFINIUM.PDF 迁移到 IronPDF

下一步：开始免费 30 天试用

下一步：开始免费 30 天试用

深受全球数百万工程师信赖