迁移指南

如何用 C# 从 PDFreactor 迁移到 IronPDF

已发布:2026年2月1日

从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对比

特点/方面	PDFreactor	IronPDF
本地 .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 生命周期管理。

开始之前

前提条件

.NET 环境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet 访问权限：能够安装 NuGet 包
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

核心类映射

PDFreactor	IronPDF	备注
`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 中嵌入 CSS	CSS 注入
`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

功能对比摘要

特征	PDFreactor	IronPDF
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 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 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# 从 PDFSharp 迁移到 IronPDF

如何在 C# 中从 PDFPrinting.NET...

立即开始30天免费试用

如何用 C# 从 PDFreactor 迁移到 IronPDF

为什么要从PDFreactor迁移到 IronPDF．

了解 PDFreactor

Java 依赖性问题

PDFreactor与IronPDF对比

开始之前

前提条件

NuGet 软件包变更

许可配置

确定PDFreactor的用法

完整的 API 参考

命名空间变更

核心类映射

配置属性映射

PDFreactor中不提供的新功能

代码迁移示例

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

示例 2：URL 到 PDF 的转换

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

关键迁移说明

无需服务器

将 CSS 分页媒体转换为IronPDFAPI.

页码占位符语法

结果处理更改

边际单位变化

迁移后的新功能

PDF 合并

水印

文本提取

密码保护

功能对比摘要

迁移清单

迁移前

软件包变更

代码更改

基础架构迁移

后迁移

相关文章

如何用 C# 从 ZetPDF 迁移到 IronPDF

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

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

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

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

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