如何用 C# 从 PDF Duo 迁移到 IronPDF

PDF 双风险问题

PDF Duo .NET 是 .NET 生态系统中一个难以捉摸、鲜为人知的库。 虽然它可能对追求简单的开发人员很有吸引力，但该库的模糊性给生产应用带来了巨大挑战：

1.出处不明：开发者身份不明，没有可验证的公司支持。 没有可见的 GitHub 仓库或源代码，NuGet 下载统计有限，许可条款不确定。

2.缺少文件：几乎不可能找到可靠的信息。 目前没有官方的 API 参考资料，社区示例稀少，也没有官方教程或指南。 由于缺乏可靠的文档，任何使用 PDF Duo 的尝试都会受到阻碍。

3.已弃用或不活跃状态：有明显的疏于管理迹象，更新频率不高或根本没有更新。 支持论坛显示 2019 年以来的帖子，但没有回复。 对于重大项目来说，被弃用的现实风险影响了其可行性。

4.功能有限：仅提供基本功能——简单的 HTML 转 PDF 和基本的 PDF 合并，没有表单、安全或水印等高级功能。

5.未知渲染引擎：对底层工作原理一无所知。 CSS/JavaScript 支持未知，渲染质量不可预测，现代网络功能支持也不确定。

6.支持风险：设备损坏时没有补救措施。 没有专业支持，没有社区帮助，完全有被放弃的风险。

PDF Duo 与IronPDF对比

对于计划在 2025 年和 2026 年之前采用 .NET 10 和 C# 14 的团队来说，IronPDF 提供了一个稳定的基础，拥有活跃的开发和全面的文档，消除了依赖废弃库的不确定性。

前提条件

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 软件包变更

# RemovePDF Duo .NET(if you can find the correct package name)
dotnet remove package PDFDuo.NET
dotnet remove package PDFDuo
dotnet remove package PDF-Duo

# Install IronPDF
dotnet add package IronPdf

# RemovePDF Duo .NET(if you can find the correct package name)
dotnet remove package PDFDuo.NET
dotnet remove package PDFDuo
dotnet remove package PDF-Duo

# Install IronPDF
dotnet add package IronPdf

许可配置

// 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";

确定 PDF Duo 的用途

# Find all PDF Duo references
grep -r "PDFDuo\|HtmlToPdfConverter\|PdfMerger" --include="*.cs" .

# Find all PDF Duo references
grep -r "PDFDuo\|HtmlToPdfConverter\|PdfMerger" --include="*.cs" .

命名空间变更

HTML 到 PDF 转换映射

页面配置映射

边距映射

文档操作映射

PDF Duo 中不提供的新功能

示例 1：HTML 到 PDF 的转换

之前（PDF Duo）：

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

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        converter.ConvertHtmlString(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

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

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        converter.ConvertHtmlString(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

After (IronPDF)：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        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();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

这里的根本区别在于 API 模式。 PDF Duo 的HtmlToPdfConverter.ConvertHtmlString()只需一次调用即可获取 HTML 和输出路径，同时处理转换和保存。IronPDF的 ChromePdfRenderer.RenderHtmlAsPdf() 首先返回一个 PdfDocument 对象，然后您可以使用 SaveAs() 保存该对象。

这种面向对象的方法具有显著的优势：您可以在保存之前对 PDF 进行操作（添加水印、合并文档、添加安全性、提取文本），而 PDF Duo 的直接到文件方法无法实现这些操作。 有关其他渲染选项，请参阅 HTML to PDF 文档。

示例 2：URL 到 PDF 的转换

之前（PDF Duo）：

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

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.ConvertUrl("https://www.example.com", "webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

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

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.ConvertUrl("https://www.example.com", "webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

After (IronPDF)：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

PDF Duo 使用相同的 HtmlToPdfConverter 类与 ConvertUrl(url, outputPath) 进行 URL 转换。IronPDF使用 ChromePdfRenderer 和专用的 RenderUrlAsPdf(url) 方法，返回一个 PdfDocument 对象。

一个关键优势是IronPDF基于 Chromium 的渲染引擎提供了现代 CSS3 和 JavaScript 支持，而 PDF Duo 未知的渲染引擎使得 CSS/JavaScript 支持不确定，渲染质量不可预测。 了解有关 URL 至 PDF 转换的更多信息。

示例 3：PDF 合并

之前（PDF Duo）：

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

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        merger.AddFile("document1.pdf");
        merger.AddFile("document2.pdf");
        merger.Merge("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

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

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        merger.AddFile("document1.pdf");
        merger.AddFile("document2.pdf");
        merger.Merge("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

After (IronPDF)：

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

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

这个例子显示了一个基本的架构差异。 PDF Duo 使用一个专用的 PdfMerger 类，该类使用 AddFile() 方法对文件进行排队，然后使用 Merge() 一步完成合并和保存。

IronPDF 使用不同的模式：使用 PdfDocument.FromFile() 将每个 PDF 作为 PdfDocument 加载，然后使用静态PdfDocument.Merge()方法将它们合并。 这会返回一个新的PdfDocument对象，您可以使用SaveAs()` 单独保存该对象。

var paths = new[] { "document1.pdf", "document2.pdf", "document3.pdf" };
var pdfs = paths.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("merged.pdf");

var paths = new[] { "document1.pdf", "document2.pdf", "document3.pdf" };
var pdfs = paths.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("merged.pdf");