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

如何用 C# 从 PDFreactor 迁移到 IronPDF

Curtis Chau
Curtis Chau
已发布:

从PDFreactor迁移到IronPDF可消除 Java 依赖性和服务器基础架构，同时通过本地 .NET 库提供等效的 HTML 到 PDF 转换功能。 本指南提供了一个完整的、循序渐进的迁移路径，将您基于 Java 的服务器架构替换为可无缝集成到 .NET 应用程序中的进程内库。

为什么要从PDFreactor迁移到 IronPDF．

了解 PDFreactor。

PDFreactor 是一款功能强大的 HTML 到 PDF 转换服务器，可跨平台集成。 作为一种商业解决方案，PDFreactor 利用其专有技术将 HTML 和 CSS 内容转换为高质量的 PDF 文档。PDFreactor的显著属性包括支持大量 CSS 属性，这使其成为复杂布局渲染的有力候选工具。

然而，PDFreactor 对 Java 的依赖给 .NET 环境带来了一定的挑战，因为 Java 的非本地性质可能会使部署和集成复杂化。 在 .NET 应用程序中，对 Java 的依赖会产生额外的开销，通常需要额外的集成工作。

Java 依赖性问题

PDFreactor 的架构给 .NET 环境带来了一些挑战：

1.需要 Java 运行时环境：需要在所有服务器上安装 JRE/JDK。

2.服务器架构：作为独立服务运行，需要额外的基础设施。 作为基于服务器的解决方案，PDFreactor 的每次转换都需要调用 REST API。

3.复杂的部署：在以 .NET 为主的生态系统中管理 Java 依赖项可能会使设置复杂化并增加维护成本。 在 CI/CD 管道中管理两种运行时（Java + .NET）。

4.进程间通信： REST API 或套接字通信会增加延迟。 每次 PDF 转换都需要 HTTP 服务器往返。

5.独立许可证管理：许可证绑定到服务器实例，而不是应用程序。 与 Java 服务实例绑定的每服务器许可。

6.资源隔离：分离进程内存和 CPU 管理。 需要监控、扩展和维护额外的服务器。

PDFreactor与IronPDF对比

特点/方面PDFreactorIronPDF
本地 .NET 库否（基于 Java）是
运行时Java（外部服务器）本地 .NET（翻译中）
架构REST API 服务NuGet 库
部署Java + 服务器配置单个 NuGet 软件包
依赖关系JRE + HTTP 客户端自成一体
延迟网络往返直接方法调用
跨平台能力是（依赖于 Java）是（捆绑 Chromium）
CSS支持对 CSS3、CSS 分页媒体的高级支持全面支持 HTML5/CSS3
部署复杂性因 Java 而更加复杂简单，直接与 .NET 集成
PDF 操作功能基础（仅限生成）广泛，包括合并、拆分、编辑和注释

IronPDF for .NET 与PDFreactor不同，它是一个本地 .NET 库，专门设计用于无缝集成到 .NET 项目中，而不需要像 Java 这样的外部依赖关系。 IronPdf 使用捆绑的 Chromium 渲染引擎，只需几行代码即可将 HTML 转换为 PDF。

对于计划在 2025 年和 2026 年之前采用 .NET 10 和 C# 14 的团队，IronPDF 提供了一个本地 .NET 解决方案，消除了 Java 服务器的复杂性，同时提供全面的 PDF 生命周期管理。

开始之前

前提条件

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

# RemovePDFreactorNuGet packages
dotnet remove package PDFreactor.NET
dotnet remove package PDFreactor.Native.Windows.x64

# StopPDFreactorserver service (if running locally)
# Windows: net stop PDFreactor
# Linux: sudo systemctl stop pdfreactor

# Install IronPDF
dotnet add package IronPdf
# RemovePDFreactorNuGet packages
dotnet remove package PDFreactor.NET
dotnet remove package PDFreactor.Native.Windows.x64

# StopPDFreactorserver service (if running locally)
# Windows: net stop PDFreactor
# Linux: sudo systemctl stop pdfreactor

# Install IronPDF
dotnet add package IronPdf
SHELL

许可配置

PDFreactor（基于服务器）：

// License configured on server via config file or command line
// Client connects to licensed server
var pdfReactor = new PDFreactor("http://pdfreactor-server:9423");
// License configured on server via config file or command line
// Client connects to licensed server
var pdfReactor = new PDFreactor("http://pdfreactor-server:9423");
$vbLabelText   $csharpLabel

IronPDF（应用级）：

// One-time setup at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
// One-time setup at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
$vbLabelText   $csharpLabel

确定PDFreactor的用法

# FindPDFreactorusage
grep -r "PDFreactor\|RealObjects\|Configuration.*Document" --include="*.cs" .

# FindCSS 分页媒体rules to convert
grep -r "@page\|counter(page)\|counter(pages)" --include="*.cs" --include="*.css" .
# FindPDFreactorusage
grep -r "PDFreactor\|RealObjects\|Configuration.*Document" --include="*.cs" .

# FindCSS 分页媒体rules to convert
grep -r "@page\|counter(page)\|counter(pages)" --include="*.cs" --include="*.css" .
SHELL

完整的 API 参考

命名空间变更

// Before: PDFreactor
using RealObjects.PDFreactor;
using System.IO;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
// Before: PDFreactor
using RealObjects.PDFreactor;
using System.IO;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
$vbLabelText   $csharpLabel

核心类映射

PDFreactorIronPDF备注
<代码>PDFreactor</代码<代码>ChromePdfRenderer</代码主要转换类
<代码>配置</代码<代码>ChromePdfRenderOptions</代码PDF 设置
<代码>结果</代码<代码>PDF 文档</代码输出文件
<代码>config.Document = html</代码<代码>renderer.RenderHtmlAsPdf(html)</代码HTML 输入
result.Document (byte[])<代码>pdf.BinaryData</代码原始字节

配置属性映射

PDFreactor 配置IronPdf 渲染选项备注
<代码>config.Document = html</代码<代码>renderer.RenderHtmlAsPdf(html)</代码HTML 内容
<代码>config.Document = url</ 代码<代码>renderer.RenderUrlAsPdf(url)</代码URL 转换
<代码>config.PageFormat = PageFormat.A4</ 代码<代码>RenderingOptions.PaperSize = PdfPaperSize.A4</ 代码纸张大小
<代码>config.PageOrientation</代码<代码>RenderingOptions.PaperOrientation</代码定位
<代码>config.PageMargins</代码<代码>RenderingOptions.MarginTop/Bottom/Left/Right</代码边距（毫米）
config.EnableJavaScript=true<代码>RenderingOptions.EnableJavaScript = true</ 代码JS 执行
<代码>config.AddUserStyleSheet(css)</代码在 HTML 中嵌入 CSSCSS 注入
<代码>config.Title</代码<代码>pdf.MetaData.Title</代码元数据
<代码>config.加密</代码<代码>pdf.SecuritySettings</代码安全性

PDFreactor中不提供的新功能

IronPdf 特点说明
<代码>PdfDocument.Merge()</代码合并多个 PDF
<代码>pdf.ApplyWatermark()</代码添加水印
<代码>pdf.ExtractAllText()</代码文本提取
<代码>pdf.Form</代码表格填写
<代码>pdf.Sign()</代码数字签名

代码迁移示例

示例 1：HTML 字符串到 PDF 的转换

之前（PDFreactor）：

// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        string html = "<html><body><h1>Hello World</h1></body></html>";

        Configuration config = new Configuration();
        config.Document = html;

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("output.pdf", result.Document);
    }
}
// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        string html = "<html><body><h1>Hello World</h1></body></html>";

        Configuration config = new Configuration();
        config.Document = html;

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("output.pdf", result.Document);
    }
}
$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");
    }
}
// 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");
    }
}
$vbLabelText   $csharpLabel

最根本的区别在于架构模式。PDFreactor需要创建一个<代码>PDFreactor</代码实例（连接到 Java 服务器）、一个单独的<代码>配置</代码对象来保存设置和 HTML 内容，调用 Convert() 返回一个<代码>结果</代码对象，最后使用 File.WriteAllBytes() 将 result.Document 字节写入文件。

IronPDF 将此简化为创建一个 ChromePdfRenderer, 使用 HTML 字符串直接调用 RenderHtmlAsPdf(), 并在返回的<代码>PDF 文档</代码上使用内置的 SaveAs() 方法。 无服务器连接、无配置对象、无手动字节处理。 请参阅 HTML 转 PDF 文档，了解全面的示例。

示例 2：URL 到 PDF 的转换

之前（PDFreactor）：

// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        Configuration config = new Configuration();
        config.Document = "https://www.example.com";

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("webpage.pdf", result.Document);
    }
}
// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        Configuration config = new Configuration();
        config.Document = "https://www.example.com";

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("webpage.pdf", result.Document);
    }
}
$vbLabelText   $csharpLabel

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

PDFreactor 对 HTML 字符串和 URL 使用相同的 config.Document 属性，并自动确定类型。 IronPdf 提供了明确的方法：RenderHtmlAsPdf() 用于 HTML 字符串，RenderUrlAsPdf() 用于 URL。 这种明确的方法可以提高代码的清晰度和 IntelliSense 支持。 在我们的教程中了解更多信息。

示例 3：带页码的页眉和页脚

之前（PDFreactor）：

// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        string html = "<html><body><h1>Document with Headers</h1><p>Content here</p></body></html>";

        Configuration config = new Configuration();
        config.Document = html;
        config.AddUserStyleSheet("@page { @top-center { content: 'Header Text'; } @bottom-center { content: 'Page ' counter(page); } }");

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("document.pdf", result.Document);
    }
}
// NuGet: Install-Package PDFreactor.Native.Windows.x64
using RealObjects.PDFreactor;
using System.IO;

class Program
{
    static void Main()
    {
       PDFreactorpdfReactor = new PDFreactor();

        string html = "<html><body><h1>Document with Headers</h1><p>Content here</p></body></html>";

        Configuration config = new Configuration();
        config.Document = html;
        config.AddUserStyleSheet("@page { @top-center { content: 'Header Text'; } @bottom-center { content: 'Page ' counter(page); } }");

        Result result = pdfReactor.Convert(config);

        File.WriteAllBytes("document.pdf", result.Document);
    }
}
$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.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Header Text"
        };

        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page}"
        };

        string html = "<html><body><h1>Document with Headers</h1><p>Content here</p></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("document.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Header Text"
        };

        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page}"
        };

        string html = "<html><body><h1>Document with Headers</h1><p>Content here</p></body></html>";

        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("document.pdf");
    }
}
$vbLabelText   $csharpLabel

本例显示了最明显的语法差异。PDFreactor使用 CSS 分页媒体语法，其中包含 @page 规则、@top-center/@bottom-center 区域和 counter(page) 用于通过 AddUserStyleSheet() 注入页码。

IronPDF 使用本地 .NET API，其中 TextHeaderFooter 对象分配给 RenderingOptions.TextHeader 和 RenderingOptions.TextFooter 。 页码使用 {page} 占位符，而不是 CSS counter(page) 。 请注意，IronPDF 还要求导入IronPdf.Rendering命名空间中的页眉/页脚类。

关键迁移说明

无需服务器

IronPDF 在进程中运行--无需配置 Java 服务器：

// PDFreactor: Requires server connection
var pdfReactor = new PDFreactor("http://localhost:9423");

// IronPDF: No server URL needed
var renderer = new ChromePdfRenderer();
// PDFreactor: Requires server connection
var pdfReactor = new PDFreactor("http://localhost:9423");

// IronPDF: No server URL needed
var renderer = new ChromePdfRenderer();
$vbLabelText   $csharpLabel

将 CSS 分页媒体转换为IronPDFAPI.

用 RenderingOptions 替换 CSS @page 规则：

//PDFreactorCSS: @page { @bottom-center { content: 'Page ' counter(page); } }
//IronPDFequivalent:
renderer.RenderingOptions.TextFooter = new TextHeaderFooter 
{ 
    CenterText = "Page {page}" 
};
//PDFreactorCSS: @page { @bottom-center { content: 'Page ' counter(page); } }
//IronPDFequivalent:
renderer.RenderingOptions.TextFooter = new TextHeaderFooter 
{ 
    CenterText = "Page {page}" 
};
$vbLabelText   $csharpLabel

页码占位符语法

//PDFreactorCSS: counter(page)
// IronPDF: {page}

//PDFreactorCSS: counter(pages)  
// IronPDF: {total-pages}
//PDFreactorCSS: counter(page)
// IronPDF: {page}

//PDFreactorCSS: counter(pages)  
// IronPDF: {total-pages}
$vbLabelText   $csharpLabel

结果处理更改

配置 + 结果模式直接变成 PdfDocument：

// PDFreactor: Configuration → Convert → Result → bytes
Result result = pdfReactor.Convert(config);
byte[] bytes = result.Document;
File.WriteAllBytes("output.pdf", bytes);

// IronPDF: Direct PdfDocument with built-in methods
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or: byte[] bytes = pdf.BinaryData;
// PDFreactor: Configuration → Convert → Result → bytes
Result result = pdfReactor.Convert(config);
byte[] bytes = result.Document;
File.WriteAllBytes("output.pdf", bytes);

// IronPDF: Direct PdfDocument with built-in methods
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Or: byte[] bytes = pdf.BinaryData;
$vbLabelText   $csharpLabel

边际单位变化

PDFreactor 使用字符串； IronPdf 使用毫米：

// PDFreactor: config.PageMargins.Top = "1in"
// IronPDF: renderer.RenderingOptions.MarginTop = 25.4  // 1 inch in mm
// PDFreactor: config.PageMargins.Top = "1in"
// IronPDF: renderer.RenderingOptions.MarginTop = 25.4  // 1 inch in mm
$vbLabelText   $csharpLabel

迁移后的新功能

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

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

文本提取

string text = pdf.ExtractAllText();
string text = pdf.ExtractAllText();
$vbLabelText   $csharpLabel

密码保护

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
$vbLabelText   $csharpLabel

功能对比摘要

特征PDFreactorIronPDF
HTML 至 PDF✓✓
URL 至 PDF✓✓
页眉/页脚CSS 分页媒体本地 API
页面设置✓✓
JavaScript 支持✓✓
本地 .NET✗✓
翻译中✗✓
合并 PDF✗✓
拆分 PDF✗✓
水印✗✓
文本提取✗✓
表格填写✗✓
数字签名✗✓

迁移清单

迁移前

  • 清点代码库中所有PDFreactor的使用情况
  • 记录所有使用的 CSS 分页媒体规则
  • 注意所有配置设置（边距、页面大小、JavaScript）
  • 规划IronPDF许可证密钥存储（建议使用环境变量）
  • 先使用IronPDF试用许可证进行测试

软件包变更

  • 删除PDFreactor.NET NuGet 包
  • 删除PDFreactor.Native.Windows.x64 NuGet 包 安装IronPdf NuGet 包： dotnet add package IronPdf

代码更改

  • 更新命名空间导入（ using RealObjects.PDFreactor; → using IronPdf; ）
  • 添加using IronPdf.Rendering;用于页眉/页脚类
  • 将PDFreactor类替换为ChromePdfRenderer
  • 将Configuration对象转换为RenderingOptions属性
  • 将config.Document = html替换为renderer.RenderHtmlAsPdf(html)
  • 将config.Document = url替换为renderer.RenderUrlAsPdf(url)
  • 将File.WriteAllBytes(path, result.Document)替换为pdf.SaveAs(path)
  • 将 CSS @page规则转换为TextHeader / TextFooter对象
  • 更新页码占位符（ counter(page) → {page} ）
  • 将边距单位从字符串转换为毫米

基础架构迁移

  • 移除 Java 运行时要求
  • 停用PDFreactor服务器
  • 更新 Docker/部署配置
  • 更新 CI/CD 流水线

后迁移

  • 测试 PDF 输出质量是否符合预期
  • 验证页眉/页脚渲染效果
  • 如果使用，请验证 JavaScript 的执行情况
  • 根据需要添加新功能（合并、水印、安全）
Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

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

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

相关文章

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