迁移指南

如何用 C# 从 jsreport 迁移到 IronPDF

已更新:一月 7, 2026

从jsreport迁移到 IronPdf：完整的 C# 迁移指南

从jsreport迁移到IronPDF可将您的 .NET PDF 工作流程从依赖 Node.js 的系统（带有外部二进制管理和单独的服务器进程）转变为完全在进程中运行的纯 .NET 库。本指南提供了一个全面、循序渐进的迁移路径，为专业的 .NET 开发人员消除了基础架构的复杂性和 JavaScript 模板要求。

为什么要从jsreport迁移到 IronPDF?

jsreport面临的挑战

jsreport 引入了不属于纯 .NET 环境的复杂性：

1.依赖 Node.js：需要 Node.js 运行时和二进制文件，这就给本应简单明了的 .NET 应用程序增加了基础结构的复杂性。

2.外部二进制文件管理：必须通过单独的 NuGet 包（jsreport.Binary, jsreport.Binary.Linux, jsreport.Binary.OSX ）下载和管理 Windows、Linux 和 OSX 平台特定的二进制文件。

3.独立服务器进程：可作为实用程序或网络服务器运行--需要使用 StartAsync() 和 KillAsync() 生命周期方法进行额外的进程管理。

4.JavaScript 模板：强制学习 Handlebars、JsRender 或其他 JavaScript 模板系统，而不是使用本地 C# 功能。

5.复杂请求结构：即使是简单的 PDF 生成，也需要使用嵌套<代码>模板</代码配置的冗长<代码>渲染请求</代码对象。

6.许可限制：免费层限制模板数量；缩放需要商业许可。

7.基于流的输出：返回需要手动文件操作和内存流管理的流。

jsreport与IronPDF对比

特征	jsreport	IronPDF
运行时间	Node.js + .NET	纯 .NET
二进制管理	手册（jsreport.二进制包）	自动翻译
服务器流程	要求（实用程序或网络服务器）	翻译中
模板制作	JavaScript（手柄等）	C# （Razor、字符串插值）
API 风格	冗长的请求对象	简洁流畅的方法
产出	流	PdfDocument 对象
PDF 操作	有限的	广泛（合并、拆分、编辑）
异步支持	仅异步	同步和异步

对于计划在 2025 年和 2026 年之前采用 .NET 10 和 C# 14 的团队来说，IronPDF 作为一个没有外部运行时依赖性的本地 .NET 库，提供了一个面向未来的基础。

迁移复杂性评估

按功能估算的工作量

特征	迁移复杂性	备注
HTML 至 PDF	极低	直接方法替换
URL 至 PDF	极低	直接方法，无变通
页眉/页脚	低	占位符语法更改
页面设置	低	属性映射
服务器生命周期	低	完全删除
二进制管理	低	完全删除

范式转换

这次jsreport迁移的根本转变是从 具有服务器管理功能的冗长请求对象到 简单的进程内方法调用：

jsreport：  LocalReporting().UseBinary().AsUtility().Create() → RenderAsync(RenderRequest) →流→ File
IronPDF：   ChromePdfRenderer → RenderHtmlAsPdf(html) → SaveAs()

开始之前

前提条件

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

# Removejsreportpackages
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSX
dotnet remove package jsreport.Local
dotnet remove package jsreport.Types
dotnet remove package jsreport.Client

# Install IronPDF
dotnet add package IronPdf

# Removejsreportpackages
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSX
dotnet remove package jsreport.Local
dotnet remove package jsreport.Types
dotnet remove package jsreport.Client

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

确定jsreport的用法

# Find alljsreportreferences
grep -r "using jsreport\|LocalReporting\|RenderRequest\|RenderAsync" --include="*.cs" .
grep -r "JsReportBinary\|Template\|Recipe\|Engine\." --include="*.cs" .

# Find alljsreportreferences
grep -r "using jsreport\|LocalReporting\|RenderRequest\|RenderAsync" --include="*.cs" .
grep -r "JsReportBinary\|Template\|Recipe\|Engine\." --include="*.cs" .

SHELL

完整的 API 参考

类映射

jsreport 类	IronPdf 同等产品	备注
<代码>本地报告</代码	<代码>ChromePdfRenderer</代码	主呈现器
<代码>报告服务</代码	<代码>ChromePdfRenderer</代码	同类
<代码>渲染请求</代码	方法参数	无需包装
<代码>模板</代码	方法参数	无需包装
<代码>Chrome</代码	<代码>渲染选项</代码	Chrome 选项
<代码>报告</代码	<代码>PDF 文档</代码	结果目标
<代码>引擎</代码	（不需要）	用于模板制作的 C# 语言

方法映射

jsreport 方法	IronPdf 同等产品	备注
<代码>LocalReporting().UseBinary().AsUtility().Create()</代码	<代码>new ChromePdfRenderer()</ 代码	单行本
<代码>rs.RenderAsync(请求)</代码	<代码>renderer.RenderHtmlAsPdf(html)</代码	直接调用
<代码>rs.StartAsync()</代码	（不需要）	翻译中
<代码>rs.KillAsync()</代码	（不需要）	自动清理
<代码>report.Content.CopyTo(stream)</代码	<代码>pdf.SaveAs(路径)</代码>或<代码>pdf.BinaryData</代码	直接访问

渲染请求属性映射

jsreport 模板属性	IronPdf 同等产品	备注
<代码>模板内容</代码	`RenderHtmlAsPdf()` 的第一个参数	直接 HTML 字符串
<代码>Template.Recipe = Recipe.ChromePdf</ 代码	（不需要）	总是 ChromePdf
`Template.Engine=Engine.None`	（不需要）	使用 C# 模板
<代码>Chrome.HeaderTemplate</代码	<代码>RenderingOptions.TextHeader</代码>或<代码>HtmlHeader</代码	HTML 标题
<代码>Chrome.FooterTemplate</代码	<代码>RenderingOptions.TextFooter</代码>或<代码>HtmlFooter</代码	HTML 页脚
<代码>Chrome.DisplayHeaderFooter</代码	（自动）	自动启用标题
<代码>Chrome.MarginTop</代码	<代码>RenderingOptions.MarginTop</代码	单位：毫米

占位符映射（页眉/页脚）

jsreport 占位符	IronPdf 占位符	备注
`<span> class="pageNumber"></span>`	`{page}`	当前页面
`<span> class="totalPages"></span>`代码	<代码>{总页数}</代码	总页数
<代码>{#pageNum}</代码	`{page}`	当前页面
<代码>{#页数}</代码	<代码>{总页数}</代码	总页数
<代码>{#timestamp}</代码	<代码>{日期}</代码	当前日期

代码迁移示例

示例 1：将基本 HTML 转换为 PDF.

之前 (jsreport)：

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<h1>Hello from jsreport</h1><p>This is a PDF document.</p>"
            }
        });

        using (var fileStream = File.Create("output.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("PDF created successfully!");
    }
}

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<h1>Hello from jsreport</h1><p>This is a PDF document.</p>"
            }
        });

        using (var fileStream = File.Create("output.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("PDF created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

After (IronPDF)：

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF</h1><p>This is a PDF document.</p>");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF</h1><p>This is a PDF document.</p>");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

jsreport 方法需要三个 NuGet 包（jsreport.Binary、jsreport.Local、jsreport.Types）、三个命名空间导入、仅异步执行、一个流畅的构建器链（LocalReporting().UseBinary().AsUtility().Create()）、带有嵌套<代码>模板</代码对象的冗长<代码>渲染请求</代码和指定 Recipe 和<代码>引擎</代码的<代码>模板</代码对象，以及带有 using 块的手动流到文件复制。

IronPdf 将其简化为一个 NuGet 包、一个命名空间、三行代码和同步执行。 ChromePdfRenderer.RenderHtmlAsPdf() 方法直接接受 HTML 并返回一个<代码>PDF 文档</代码和一个简单的 SaveAs() 方法。有关其他渲染选项，请参阅 HTML to PDF 文档。

示例 2：URL 转 PDF.

之前 (jsreport)：

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<html><body><script>window.location='https://example.com';</script></body></html>"
            }
        });

        using (var fileStream = File.Create("webpage.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("Webpage PDF created successfully!");
    }
}

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<html><body><script>window.location='https://example.com';</script></body></html>"
            }
        });

        using (var fileStream = File.Create("webpage.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("Webpage PDF created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

After (IronPDF)：

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage PDF created successfully!");
    }
}

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage PDF created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

本示例突出了jsreport的一个重要局限：没有直接的 URL 到 PDF 方法。jsreport代码必须使用嵌入 HTML 内容的 JavaScript 重定向变通方法（window.location='https://example.com'）来捕获网页。这种间接的方法在某些网站上可能会失败，并增加不必要的复杂性。

IronPDF 提供了专门的 RenderUrlAsPdf() 方法，可直接渲染任何 URL，并支持完整的 JavaScript 执行和现代 CSS。无需变通方法，无需嵌入脚本，只需传递 URL 即可。了解有关 URL 至 PDF 转换的更多信息。

示例 3：带页眉和页脚的 PDF 文件

之前 (jsreport)：

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<h1>Document with Header and Footer</h1><p>Main content goes here.</p>",
                Chrome = new Chrome()
                {
                    DisplayHeaderFooter = true,
                    HeaderTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Custom Header</div>",
                    FooterTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Page <span class='pageNumber'></span> of <span class='totalPages'></span></div>"
                }
            }
        });

        using (var fileStream = File.Create("document_with_headers.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("PDF with headers and footers created successfully!");
    }
}

// NuGet: Install-Package jsreport.Binary
// NuGet: Install-Package jsreport.Local
// NuGet: Install-Package jsreport.Types
using jsreport.Binary;
using jsreport.Local;
using jsreport.Types;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var rs = new LocalReporting()
            .UseBinary(JsReportBinary.GetBinary())
            .AsUtility()
            .Create();

        var report = await rs.RenderAsync(new RenderRequest()
        {
            Template = new Template()
            {
                Recipe = Recipe.ChromePdf,
                Engine = Engine.None,
                Content = "<h1>Document with Header and Footer</h1><p>Main content goes here.</p>",
                Chrome = new Chrome()
                {
                    DisplayHeaderFooter = true,
                    HeaderTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Custom Header</div>",
                    FooterTemplate = "<div style='font-size:10px; text-align:center; width:100%;'>Page <span class='pageNumber'></span> of <span class='totalPages'></span></div>"
                }
            }
        });

        using (var fileStream = File.Create("document_with_headers.pdf"))
        {
            report.Content.CopyTo(fileStream);
        }

        Console.WriteLine("PDF with headers and footers created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

After (IronPDF)：

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Custom Header",
            FontSize = 10
        };
        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page} of {total-pages}",
            FontSize = 10
        };

        var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Header and Footer</h1><p>Main content goes here.</p>");
        pdf.SaveAs("document_with_headers.pdf");
        Console.WriteLine("PDF with headers and footers created successfully!");
    }
}

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

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
        {
            CenterText = "Custom Header",
            FontSize = 10
        };
        renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
        {
            CenterText = "Page {page} of {total-pages}",
            FontSize = 10
        };

        var pdf = renderer.RenderHtmlAsPdf("<h1>Document with Header and Footer</h1><p>Main content goes here.</p>");
        pdf.SaveAs("document_with_headers.pdf");
        Console.WriteLine("PDF with headers and footers created successfully!");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

jsreport 方法要求在<代码>模板</代码中添加<代码>Chrome</代码对象，设置 DisplayHeaderFooter = true 并使用带有特殊 CSS 类占位符（ class="pageNumber">,  class="totalPages"> ）的 HTML 模板。页眉和页脚模板必须包含完整的内联样式。

IronPdf 提供了更简洁的 TextHeaderFooter 配置，并为 CenterText, LeftText, RightText 和 FontSize 提供了专用属性。页码占位符使用更简单的{page}和<代码>{总页数}</代码语法。有关 HTML 页眉选项，请参阅页眉和页脚文档。

关键迁移说明

消除服务器生命周期管理

jsreport 需要明确的服务器生命周期管理：

//jsreport(DELETE THIS):
var rs = new LocalReporting()
    .UseBinary(JsReportBinary.GetBinary())
    .AsUtility()
    .Create();

// Or for web server mode:
var rs = new LocalReporting()
    .UseBinary(JsReportBinary.GetBinary())
    .AsWebServer()
    .Create();

await rs.StartAsync();
// ... use rs ...
await rs.KillAsync();

//jsreport(DELETE THIS):
var rs = new LocalReporting()
    .UseBinary(JsReportBinary.GetBinary())
    .AsUtility()
    .Create();

// Or for web server mode:
var rs = new LocalReporting()
    .UseBinary(JsReportBinary.GetBinary())
    .AsWebServer()
    .Create();

await rs.StartAsync();
// ... use rs ...
await rs.KillAsync();

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF 完全在进程中运行--无需启动服务器、无需进程管理、无需清理：

// IronPDF:
var renderer = new ChromePdfRenderer();
// Just use it—no lifecycle management needed

// IronPDF:
var renderer = new ChromePdfRenderer();
// Just use it—no lifecycle management needed

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

移除特定平台的二进制包

jsreport 需要为每个目标平台分别提供 NuGet 包：

# DELETE these platform-specific packages:
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSX

# DELETE these platform-specific packages:
dotnet remove package jsreport.Binary
dotnet remove package jsreport.Binary.Linux
dotnet remove package jsreport.Binary.OSX

SHELL

IronPDF 通过一个 NuGet 包自动处理所有平台要求。

更新占位符语法

jsreport 使用 CSS 类占位符或大括号占位符。 IronPdf 使用不同的语法：

//jsreportplaceholders:
"<span class='pageNumber'></span>"  // or {#pageNum}
"<span class='totalPages'></span>"  // or {#numPages}

//IronPDFplaceholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"

//jsreportplaceholders:
"<span class='pageNumber'></span>"  // or {#pageNum}
"<span class='totalPages'></span>"  // or {#numPages}

//IronPDFplaceholders:
"{page}"
"{total-pages}"
"{date}"
"{html-title}"

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

使用 C# 字符串插值替换手柄

jsreport 经常使用 Engine.Handlebars 的 Handlebars 模板：

//jsreportHandlebars (DELETE THIS):
Template = new Template
{
    Content = "<h1>Hello, {{name}}</h1>",
    Engine = Engine.Handlebars
},
Data = new { name = "World" }

//IronPDFwith C# string interpolation:
string name = "World";
string html = $"<h1>Hello, {name}</h1>";
var pdf = renderer.RenderHtmlAsPdf(html);

//jsreportHandlebars (DELETE THIS):
Template = new Template
{
    Content = "<h1>Hello, {{name}}</h1>",
    Engine = Engine.Handlebars
},
Data = new { name = "World" }

//IronPDFwith C# string interpolation:
string name = "World";
string html = $"<h1>Hello, {name}</h1>";
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

简化流处理

jsreport 返回一个需要手动复制的流：

//jsreportstream handling (DELETE THIS):
using (var fileStream = File.Create("output.pdf"))
{
    report.Content.CopyTo(fileStream);
}

// Or for byte array:
using (var memoryStream = new MemoryStream())
{
    await report.Content.CopyToAsync(memoryStream);
    return memoryStream.ToArray();
}

//IronPDFdirect access:
pdf.SaveAs("output.pdf");
// Or:
byte[] bytes = pdf.BinaryData;

//jsreportstream handling (DELETE THIS):
using (var fileStream = File.Create("output.pdf"))
{
    report.Content.CopyTo(fileStream);
}

// Or for byte array:
using (var memoryStream = new MemoryStream())
{
    await report.Content.CopyToAsync(memoryStream);
    return memoryStream.ToArray();
}

//IronPDFdirect access:
pdf.SaveAs("output.pdf");
// Or:
byte[] bytes = pdf.BinaryData;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

故障排除

问题 1：未找到本地报告

问题：代码引用了<代码>本地报告</代码类，而该类在IronPDF中并不存在。

解决方案：替换为 ChromePdfRenderer：

// jsreport
var rs = new LocalReporting().UseBinary().AsUtility().Create();

// IronPDF
var renderer = new ChromePdfRenderer();

// jsreport
var rs = new LocalReporting().UseBinary().AsUtility().Create();

// IronPDF
var renderer = new ChromePdfRenderer();

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

问题 2：未找到渲染请求

问题：代码使用<代码>渲染请求</代码和<代码>模板</代码封装对象。

解决方案：直接将 HTML 传递给呈现方法：

// jsreport
await rs.RenderAsync(new RenderRequest { Template = new Template { Content = html } });

// IronPDF
var pdf = renderer.RenderHtmlAsPdf(html);

// jsreport
await rs.RenderAsync(new RenderRequest { Template = new Template { Content = html } });

// IronPDF
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

问题 3：页码未显示

问题：使用jsreport占位符语法  class="pageNumber">.

解决方案：更新 IronPdf 占位符语法：

//jsreportsyntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"

//IronPDFsyntax
"Page {page} of {total-pages}"

//jsreportsyntax (won't work)
"Page <span class='pageNumber'></span> of <span class='totalPages'></span>"

//IronPDFsyntax
"Page {page} of {total-pages}"

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

问题 4：未找到 JsReportBinary

问题：代码引用了 JsReportBinary.GetBinary().

解决方案：完全删除-IronPdf 不需要外部二进制文件：

// DELETE thisjsreportpattern:
.UseBinary(JsReportBinary.GetBinary())

//IronPDFneeds nothing—just create the renderer:
var renderer = new ChromePdfRenderer();

// DELETE thisjsreportpattern:
.UseBinary(JsReportBinary.GetBinary())

//IronPDFneeds nothing—just create the renderer:
var renderer = new ChromePdfRenderer();

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

迁移清单

迁移前

[ ] 识别所有jsreportusing 语句
[ ] 使用 Handlebars/JsRender 制作列表模板（转换为 C# 字符串插值法）
[ ] 文档当前使用的 Chrome 选项（页边距、纸张大小）
[ ] 检查网络服务器模式与实用程序模式（两者都在进程中）
[ ] 注意特定平台的二进制包（全部删除）
[ ] 获取 IronPdf 许可证密钥

软件包变更

[ ] 删除 jsreport.Binary 包
[ ] 删除 jsreport.Binary.Linux 包
[ ] 删除 jsreport.Binary.OSX 包
[ ] 删除 jsreport.Local 软件包
[ ] 删除 jsreport.Types 包
[ ] 删除 jsreport.Client 包
[ ] 安装 IronPdf 软件包

代码更改

[ ] 在启动时添加许可证密钥配置
[ ] 将<代码>本地报告</代码替换为 ChromePdfRenderer
[ ] 移除<代码>渲染请求</代码包装器
[ ] 移除<代码>模板</代码wrapper
[ ] 更新占位符语法（ class="pageNumber"> → {page})
[ ] 使用 C# 字符串插值替换 Handlebars
[ ] 删除 StartAsync() / KillAsync() 调用
[用 BinaryData 或 SaveAs() 替换流复制

测试

[ ] 测试所有 PDF 生成路径
[ ] 验证页眉/页脚渲染
[ ] 检查页码
[ ] 验证页边距
[ ] 测试复杂的 CSS/JavaScript 页面
[ ] 基准性能

后迁移

[ ] 删除jsreport二进制文件
[ ] 删除不再需要的 Node.js 依赖项
[ ] 更新部署脚本
[ ] 更新文档

结论

从jsreport迁移到IronPDF可以消除 Node.js 依赖性、外部二进制管理和服务器生命周期处理的复杂性。从冗长的<代码>渲染请求</代码对象到简单的方法调用，这一范式的转变大大减少了代码量，同时保持了完整的 PDF 生成功能。

本次迁移的主要变化有 1.运行时：Node.js + .NET → 纯 .NET 2.服务器流程：必填 → 处理中（已淘汰） 3.二进制管理：手动平台包 → 自动 4.模板：JavaScript (Handlebars) → C# (字符串插值) 5.API 风格：冗长的请求对象 → 简洁流畅的方法 6.占位符： class="pageNumber">→{page}

探索完整的IronPDF文档、教程和API参考，加速您的jsreport迁移。

Curtis Chau

立即与工程团队聊天

技术作家

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

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

如何用 C# 从 Kaizen.io 迁移到 IronPDF

如何用 C# 从 iText 迁移到 IronPDF

如何用 C# 从 jsreport 迁移到 IronPDF

从jsreport迁移到 IronPdf：完整的 C# 迁移指南

为什么要从jsreport迁移到 IronPDF?

jsreport面临的挑战

jsreport与IronPDF对比

迁移复杂性评估

按功能估算的工作量

范式转换

开始之前

前提条件

NuGet 软件包变更

许可配置

确定jsreport的用法

完整的 API 参考

类映射

方法映射

渲染请求属性映射

占位符映射（页眉/页脚）

代码迁移示例

示例 1：将基本 HTML 转换为 PDF.

示例 2：URL 转 PDF.

示例 3：带页眉和页脚的 PDF 文件

关键迁移说明

消除服务器生命周期管理

移除特定平台的二进制包

更新占位符语法

使用 C# 字符串插值替换手柄

简化流处理

故障排除

问题 1：未找到本地报告

问题 2：未找到渲染请求

问题 3：页码未显示

问题 4：未找到 JsReportBinary

迁移清单

迁移前

软件包变更

代码更改

测试

后迁移

结论

相关文章

如何用 C# 从 WebView2 迁移到 IronPDF

如何用 C# 从 iText 迁移到 IronPDF

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

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

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

深受全球 200 多万工程师信赖