IRONSOFTWAREHOME
IRONSUITE所有10的价格为2
联系销售
按公司
加入我们的专家网络
视频

如何使用 C# 将 SVG 转换为 PDF

Curtis Chau
Curtis Chau
Updated: 2026年7月19日

从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。

对于采用现代.NET版本的团队，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 软件包变更

#PDFreactoris NOT distributed via NuGet. The .NET wrapper ships as
# PDFreactor.dll inside <PDFreactor-install>/clients/netstandard2/bin/
# (or netframework40/bin for older .NET Framework projects).
# Remove the assembly reference from your .csproj.

# StopPDFreactorWeb Service (Java/Jetty, default port 9423)
# Windows: net stop PDFreactor
# Linux:   sudo systemctl stop pdfreactor

# Install IronPDF
dotnet add package IronPdf
SHELL

许可配置

PDFreactor（基于服务器）：

// License configured on thePDFreactorWeb Service via config file or command line.
// The .NET client (RealObjects.PDFreactor.Webservice.Client) connects to that licensed service.
var pdfReactor = new PDFreactor("http://pdfreactor-server:9423/service/rest");
C#

IronPDF（应用级）：

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

确定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" .
SHELL

完整的 API 参考

命名空间变更

// Before:PDFreactor(Web Service client)
using RealObjects.PDFreactor.Webservice.Client;
using System.IO;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
C#

核心类映射

PDFreactorIronPDF
PDFreactorChromePdfRenderer
ConfigurationChromePdfRenderOptions
ResultPdfDocument
config.Document = htmlrenderer.RenderHtmlAsPdf(html)
result.Document (byte[])pdf.BinaryData

配置属性映射

PDFreactor 配置IronPDF 渲染选项
config.Document = htmlrenderer.RenderHtmlAsPdf(html)
config.Document = urlrenderer.RenderUrlAsPdf(url)
config.PageFormat = PageFormat.A4RenderingOptions.PaperSize = PdfPaperSize.A4
config.PageOrientationRenderingOptions.PaperOrientation
config.PageMarginsRenderingOptions.MarginTop/Bottom/Left/Right
config.EnableJavaScript = trueRenderingOptions.EnableJavaScript = true
config.UserStyleSheets = new List<Resource>{...}在 HTML 中嵌入 CSS
config.Titlepdf.MetaData.Title
config.Encryptionpdf.SecuritySettings

PDFreactor中不提供的新功能

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

代码迁移示例

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

之前（PDFreactor）：

//PDFreactor.NET wrapper is a Web Service client (no NuGet package).
// Reference PDFreactor.dll from <PDFreactor-install>/clients/netstandard2/bin/
// and run thePDFreactorWeb Service (Java/Jetty) locally or remotely.
using RealObjects.PDFreactor.Webservice.Client;
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);
    }
}
C#

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");
    }
}

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

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

示例 2：URL 到 PDF 的转换

之前（PDFreactor）：

//PDFreactor.NET wrapper is a Web Service client (no NuGet package).
// Reference PDFreactor.dll from <PDFreactor-install>/clients/netstandard2/bin/
// and run thePDFreactorWeb Service (Java/Jetty) locally or remotely.
using RealObjects.PDFreactor.Webservice.Client;
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);
    }
}
C#

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");
    }
}

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

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

之前（PDFreactor）：

//PDFreactor.NET wrapper is a Web Service client (no NuGet package).
// Reference PDFreactor.dll from <PDFreactor-install>/clients/netstandard2/bin/
// and run thePDFreactorWeb Service (Java/Jetty) locally or remotely.
using RealObjects.PDFreactor.Webservice.Client;
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.UserStyleSheets = new System.Collections.Generic.List<Resource>
        {
            new Resource { Content = "@page { @top-center { content: 'Header Text'; } @bottom-center { content: 'Page ' counter(page); } }" }
        };
        
        Result result = pdfReactor.Convert(config);
        
        File.WriteAllBytes("document.pdf", result.Document);
    }
}
C#

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");
    }
}

本例显示了最明显的语法差异。PDFreactor使用 CSS 分页媒体语法与 @page 规则，@bottom-center 区域，以及通过 UserStyleSheets 列出的 Resource 项目注入的页码 counter(page)。

IronPDF 使用本机 .NET API，将 TextHeaderFooter 对象分配给 RenderingOptions.TextHeader 和 RenderingOptions.TextFooter。 页码使用 {page} 占位符而不是 CSS counter(page)。

关键迁移说明

无需服务器

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

// PDFreactor: Requires the Web Service running on a reachable host
var pdfReactor = new PDFreactor("http://localhost:9423/service/rest");

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

将 CSS 分页媒体转换为IronPDF API

用 RenderingOptions 替换 CSS @page 规则：

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

页码占位符语法

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

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

结果处理更改

配置 + 结果模式直接变成 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 使用字符串；IronPDF使用毫米：

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

迁移后的新功能

迁移到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");

水印

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

文本提取

string text = pdf.ExtractAllText();

密码保护

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

功能对比摘要

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

迁移清单

迁移前

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

软件包变更

  • 从您的 .csproj 中移除直接的 PDFreactor.dll 程序集引用
  • 退役PDFreactor Web服务（Java/Jetty）
  • 安装 IronPdf NuGet 包：dotnet add package IronPdf

代码更改

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

基础架构迁移

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

后迁移

  • 测试 PDF 输出质量是否符合预期
  • 验证页眉/页脚渲染效果
  • 如果使用，请验证 JavaScript 的执行情况
  • 根据需要添加新功能（合并、水印、安全）。
请注意: PDFReactor是其各自所有者的注册商标。 本网站与RealObjects无关，也未得到其认可或赞助。 所有产品名称、徽标和品牌均为各自所有者的财产。 比较仅供参考，反映撰写时公开可用的信息。
Curtis Chau
Curtis Chau
技术作家

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

...
阅读更多

相关文章

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
预约您的免费现场演示
Booking Badge

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

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户