跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. 迁移指南
  4. 从 pdfprinting.net 迁移到 IronPDF for .NET
迁移指南

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

Curtis Chau
Curtis Chau
已发布:

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

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

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

开始之前

前提条件

  1. .NET 环境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
  2. NuGet 访问权限：能够安装 NuGet 包
  3. 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.NETIronPDF备注
<代码>PDFPrinter</代码<代码>PDF 文档</代码PDF 核心对象
<代码>HtmlToPdfConverter</代码<代码>ChromePdfRenderer</代码生成 PDF
<代码>WebPageToPdfConverter</代码<代码>ChromePdfRenderer</代码URL 转换
打印设置属性<代码>打印设置</代码打印配置

打印方法映射

PDFPrinting.NETIronPDF备注
<代码>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.NETIronPDF
无声印刷✓✓
打印设置✓✓
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
  立即与工程团队聊天
技术作家

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

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

相关文章

30天试用 → 完整产品。无限制。无卡。 免费试用