迁移指南

如何在 C# 中从 NReco PDF 生成器迁移到 IronPDF

已更新:2026年2月1日

为什么要从 NReco PDF 生成器迁移到 IronPDF?

NReco PDF 生成器的关键安全问题

NReco PDF Generator 封装了废弃的 wkhtmltopdf 二进制文件，继承了其所有安全漏洞。这不是一个理论上的问题--自 wkhtmltopdf 于 2020 年被弃用以来，已有 20 多个记录在案的 CVE，但却没有可用的补丁：

CVE-2020-21365：服务器端请求伪造 (SSRF)
CVE-2022-35583：通过 HTML 注入读取本地文件
CVE-2022-35580：远程代码执行漏洞

由于底层 wkhtmltopdf 项目已不再维护，因此无法修补这些漏洞。

NReco PDF 生成器的其他限制

1.带水印的免费版本：生产用途需要付费许可证，定价不透明，需要联系销售人员。

2.已弃用的渲染引擎： WebKit Qt（大约在 2012 年）提供的现代 Web 支持有限：

无 CSS 网格或 Flexbox
无现代 JavaScript（ES6+）
网页字体支持不佳
无 CSS 变量或自定义属性

3.外部二进制依赖：需要管理每个平台的 wkhtmltopdf 二进制文件（wkhtmltopdf.exe，wkhtmltox.dll）。

4.无主动开发：封装器得到维护，但底层引擎没有更新。

5.异步支持有限：同步 API 会阻塞 Web 应用程序中的线程。

NReco PDF 生成器与IronPDF的比较

方面	NReco PDF 生成器	IronPDF
渲染引擎	WebKit Qt (2012)	Chromium （当前）
安全性	20 多个 CVE，无补丁	主动安全更新
CSS 支持	CSS2.1, 有限 CSS3	完全 CSS3、网格、Flexbox
JavaScript	基本 ES5	完整的 ES6+、async/await
依赖关系	外部 wkhtmltopdf 二进制文件	自成一体
异步支持	仅同步	完整的异步/等待
网络字体	有限的	完整的谷歌字体，@font-face
许可	定价不透明，请联系销售人员	透明定价
免费试用	带水印	全部功能

对于计划在 2025 年和 2026 年之前采用 .NET 10 和 C# 14 的团队来说，IronPDF 提供了一个面向未来的基础，具有主动开发和现代渲染功能。

开始之前

前提条件

.NET 环境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet 访问权限：能够安装 NuGet 包
IronPDF 许可证：请从ironpdf.com获取您的许可证密钥。

NuGet 软件包变更

# Remove NReco.PdfGenerator
dotnet remove package NReco.PdfGenerator

# Install IronPDF
dotnet add package IronPdf

# Remove NReco.PdfGenerator
dotnet remove package NReco.PdfGenerator

# Install IronPDF
dotnet add package IronPdf

SHELL

同时从您的部署中删除 wkhtmltopdf 二进制文件：

从项目中删除 wkhtmltopdf.exe 和 wkhtmltox.dll
删除任何 wkhtmltopdf 安装脚本
删除特定平台的二进制文件夹

许可配置

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

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

$vbLabelText $csharpLabel

确定 NReco PDF 生成器的用途

# Find all NReco.PdfGenerator references
grep -r "NReco.PdfGenerator\|HtmlToPdfConverter\|GeneratePdf" --include="*.cs" .

# Find all NReco.PdfGenerator references
grep -r "NReco.PdfGenerator\|HtmlToPdfConverter\|GeneratePdf" --include="*.cs" .

SHELL

完整的 API 参考

核心类映射

NReco PDF 生成器	IronPDF
`HtmlToPdfConverter`	`ChromePdfRenderer`
`PageMargins`	个别边距属性
`PageOrientation`	`PdfPaperOrientation`
`PageSize`	`PdfPaperSize`

渲染方法映射

NReco PDF 生成器	IronPDF
`GeneratePdf(html)`	`RenderHtmlAsPdf(html)`
`GeneratePdfFromFile(url, output)`	`RenderUrlAsPdf(url)`
`GeneratePdfFromFile(htmlPath, output)`	`RenderHtmlFileAsPdf(path)`
（不支持异步）	`RenderHtmlAsPdfAsync(html)`
（不支持异步）	`RenderUrlAsPdfAsync(url)`

页面配置映射

NReco PDF 生成器	IronPDF
`PageWidth = 210`	`RenderingOptions.PaperSize = PdfPaperSize.A4`
`PageHeight = 297`	`RenderingOptions.SetCustomPaperSizeinMilimeters(w, h)`
`Orientation = PageOrientation.Landscape`	`RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape`
`Size = PageSize.A4`	`RenderingOptions.PaperSize = PdfPaperSize.A4`

边距映射

NReco PDF 生成器	IronPDF
`Margins.Top = 10`	`RenderingOptions.MarginTop = 10`
`Margins.Bottom = 10`	`RenderingOptions.MarginBottom = 10`
`Margins.Left = 10`	`RenderingOptions.MarginLeft = 10`
`Margins.Right = 10`	`RenderingOptions.MarginRight = 10`
`new PageMargins { ... }`	个别属性

页眉/页脚占位符映射

NReco PDF 生成器 (wkhtmltopdf)	IronPDF
`[page]`	`{page}`
`[topage]`	`{total-pages}`
`[date]`	`{date}`
`[time]`	`{time}`
`[title]`	`{html-title}`

输出处理映射

NReco PDF 生成器	IronPDF
`byte[] pdfBytes = GeneratePdf(html)`	`PdfDocument pdf = RenderHtmlAsPdf(html)`
`File.WriteAllBytes(path, bytes)`	`pdf.SaveAs(path)`
`return pdfBytes`	`return pdf.BinaryData`
`new MemoryStream(pdfBytes)`	`pdf.Stream`

代码迁移示例

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

之前（NReco PDF 生成器）：

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

Imports NReco.PdfGenerator
Imports System.IO

Class Program
    Shared Sub Main()
        Dim htmlToPdf = New HtmlToPdfConverter()
        Dim htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"
        Dim pdfBytes = htmlToPdf.GeneratePdf(htmlContent)
        File.WriteAllBytes("output.pdf", pdfBytes)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports System.IO

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF document.</p></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

基本区别在于返回类型和保存模式。NReco PDF 生成器的 HtmlToPdfConverter.GeneratePdf() 返回一个 byte[]，您必须使用 File.WriteAllBytes() 手动将其写入磁盘。IronPDF的 ChromePdfRenderer.RenderHtmlAsPdf() 返回一个 PdfDocument 对象，该对象具有内置的 SaveAs() 方法。

这种面向对象的方法还有其他好处：您可以在保存之前对 PDF 进行操作（添加水印、合并文档、添加安全性）。如果您需要原始字节以与现有代码兼容，请使用 pdf.BinaryData。有关其他渲染选项，请参阅 HTML to PDF 文档。

示例 2：带边距的自定义页面大小

之前（NReco PDF 生成器）：

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        htmlToPdf.PageWidth = 210;
        htmlToPdf.PageHeight = 297;
        htmlToPdf.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("custom-size.pdf", pdfBytes);
    }
}

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        htmlToPdf.PageWidth = 210;
        htmlToPdf.PageHeight = 297;
        htmlToPdf.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdfBytes = htmlToPdf.GeneratePdf(htmlContent);
        File.WriteAllBytes("custom-size.pdf", pdfBytes);
    }
}

Imports NReco.PdfGenerator
Imports System.IO

Class Program
    Shared Sub Main()
        Dim htmlToPdf = New HtmlToPdfConverter()
        htmlToPdf.PageWidth = 210
        htmlToPdf.PageHeight = 297
        htmlToPdf.Margins = New PageMargins With {.Top = 10, .Bottom = 10, .Left = 10, .Right = 10}
        Dim htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>"
        Dim pdfBytes = htmlToPdf.GeneratePdf(htmlContent)
        File.WriteAllBytes("custom-size.pdf", pdfBytes)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("custom-size.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        var htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("custom-size.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 10
        renderer.RenderingOptions.MarginBottom = 10
        renderer.RenderingOptions.MarginLeft = 10
        renderer.RenderingOptions.MarginRight = 10
        Dim htmlContent = "<html><body><h1>Custom Page Size</h1><p>A4 size document with margins.</p></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("custom-size.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

NReco PDF 生成器使用数值维度（PageWidth = 210，PageHeight = 297）和 PageMargins 对象。IronPDF使用 PdfPaperSize 枚举（包括 A4、Letter、Legal 等标准尺寸）和 RenderingOptions 对象上的各个边距属性。

关键的迁移变化：

PageWidth/PageHeight → RenderingOptions.PaperSize = PdfPaperSize.A4
new PageMargins { Top = 10, ... }→ Individual properties: RenderingOptions.MarginTop = 10

对于枚举未涵盖的自定义纸张尺寸，请使用 RenderingOptions.SetCustomPaperSizeinMilimeters(width, height)。了解页面配置选项的更多信息。

示例 3：URL 到 PDF 的转换

之前（NReco PDF 生成器）：

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var pdfBytes = htmlToPdf.GeneratePdfFromFile("https://www.example.com", null);
        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}

// NuGet: Install-Package NReco.PdfGenerator
using NReco.PdfGenerator;
using System.IO;

class Program
{
    static void Main()
    {
        var htmlToPdf = new HtmlToPdfConverter();
        var pdfBytes = htmlToPdf.GeneratePdfFromFile("https://www.example.com", null);
        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}

Imports NReco.PdfGenerator
Imports System.IO

Class Program
    Shared Sub Main()
        Dim htmlToPdf As New HtmlToPdfConverter()
        Dim pdfBytes As Byte() = htmlToPdf.GeneratePdfFromFile("https://www.example.com", Nothing)
        File.WriteAllBytes("webpage.pdf", pdfBytes)
    End Sub
End Class

$vbLabelText $csharpLabel

After (IronPDF)：

// NuGet: Install-Package IronPdf
using IronPdf;

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;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

NReco PDF Generator 对本地文件和 URL 都使用了名称令人困惑的 GeneratePdfFromFile() 方法，并且第二个参数可以为空。IronPDF提供专用方法：RenderUrlAsPdf() 用于 URL，RenderHtmlFileAsPdf() 用于本地 HTML 文件。

IronPDF 的方法更简洁、更直观。对于异步 Web 应用程序，请使用 await renderer.RenderUrlAsPdfAsync(url) 来避免阻塞线程——这是NReco PDF 生成器无法做到的。

关键迁移说明

缩放值转换

NReco PDF Generator 使用浮点数值（0.0-2.0），而IronPDF使用百分比整数：

// NReco PDF Generator: Zoom = 0.9f (90%)
// IronPDF: Zoom = 90

// Conversion formula:
int ironPdfZoom = (int)(nrecoZoom * 100);

// NReco PDF Generator: Zoom = 0.9f (90%)
// IronPDF: Zoom = 90

// Conversion formula:
int ironPdfZoom = (int)(nrecoZoom * 100);

' NReco PDF Generator: Zoom = 0.9F (90%)
' IronPDF: Zoom = 90

' Conversion formula:
Dim ironPdfZoom As Integer = CInt(nrecoZoom * 100)

$vbLabelText $csharpLabel

占位符语法更新

必须更新所有页眉/页脚占位符：

NReco PDF 生成器	IronPDF
`[page]`	`{page}`
`[topage]`	`{total-pages}`
`[date]`	`{date}`
`[title]`	`{html-title}`

// NReco PDF Generator:
converter.PageFooterHtml = "<div>Page [page] of [topage]</div>";

// IronPDF:
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

// NReco PDF Generator:
converter.PageFooterHtml = "<div>Page [page] of [topage]</div>";

// IronPDF:
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

Imports NReco.PdfGenerator
Imports IronPdf

' NReco PDF Generator:
converter.PageFooterHtml = "<div>Page [page] of [topage]</div>"

' IronPDF:
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    .MaxHeight = 20
}

$vbLabelText $csharpLabel

返回类型更改

NReco PDF Generator 直接返回 byte[]；IronPDF返回 PdfDocument:

//NReco PDF 生成器pattern:
byte[] pdfBytes = converter.GeneratePdf(html);
File.WriteAllBytes("output.pdf", pdfBytes);

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// Or if you need bytes:
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

//NReco PDF 生成器pattern:
byte[] pdfBytes = converter.GeneratePdf(html);
File.WriteAllBytes("output.pdf", pdfBytes);

//IronPDFpattern:
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// Or if you need bytes:
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

Imports System.IO

' NReco PDF 生成器pattern:
Dim pdfBytes As Byte() = converter.GeneratePdf(html)
File.WriteAllBytes("output.pdf", pdfBytes)

' IronPDFpattern:
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

' Or if you need bytes:
Dim pdfBytes As Byte() = renderer.RenderHtmlAsPdf(html).BinaryData

$vbLabelText $csharpLabel

线程安全和可重用性

NReco PDF 生成器通常每次调用都会创建一个新的转换器。IronPDF的 ChromePdfRenderer 是线程安全的，可以重复使用：

//NReco PDF 生成器pattern (creates new each time):
public byte[] Generate(string html)
{
    var converter = new HtmlToPdfConverter();
    return converter.GeneratePdf(html);
}

//IronPDFpattern (reuse renderer, thread-safe):
private readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

public byte[] Generate(string html)
{
    return _renderer.RenderHtmlAsPdf(html).BinaryData;
}

//NReco PDF 生成器pattern (creates new each time):
public byte[] Generate(string html)
{
    var converter = new HtmlToPdfConverter();
    return converter.GeneratePdf(html);
}

//IronPDFpattern (reuse renderer, thread-safe):
private readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

public byte[] Generate(string html)
{
    return _renderer.RenderHtmlAsPdf(html).BinaryData;
}

Imports NReco.PdfGenerator
Imports IronPdf

' NReco PDF 生成器pattern (creates new each time):
Public Function Generate(html As String) As Byte()
    Dim converter As New HtmlToPdfConverter()
    Return converter.GeneratePdf(html)
End Function

' IronPDFpattern (reuse renderer, thread-safe):
Private ReadOnly _renderer As New ChromePdfRenderer()

Public Function Generate(html As String) As Byte()
    Return _renderer.RenderHtmlAsPdf(html).BinaryData
End Function

$vbLabelText $csharpLabel

异步支持（新功能）

IronPDF 支持NReco PDF 生成器无法提供的异步/等待模式：

// NReco PDF Generator: No async support available

// IronPDF: Full async support
public async Task<byte[]> GenerateAsync(string html)
{
    var pdf = await _renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

// NReco PDF Generator: No async support available

// IronPDF: Full async support
public async Task<byte[]> GenerateAsync(string html)
{
    var pdf = await _renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

Imports System.Threading.Tasks

' NReco PDF Generator: No async support available

' IronPDF: Full async support
Public Async Function GenerateAsync(html As String) As Task(Of Byte())
    Dim pdf = Await _renderer.RenderHtmlAsPdfAsync(html)
    Return pdf.BinaryData
End Function

$vbLabelText $csharpLabel

故障排除

问题 1：HtmlToPdfConverter 未找到

问题：IronPDF中不存在 HtmlToPdfConverter 类。

解决方案：使用 ChromePdfRenderer:

// NReco PDF Generator
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

// NReco PDF Generator
var converter = new HtmlToPdfConverter();

// IronPDF
var renderer = new ChromePdfRenderer();

' NReco PDF Generator
Dim converter As New HtmlToPdfConverter()

' IronPDF
Dim renderer As New ChromePdfRenderer()

$vbLabelText $csharpLabel

问题 2：GeneratePdf 返回错误类型

问题：代码期望 byte[]，但得到 PdfDocument。

解决方案：访问 .BinaryData 属性：

// NReco PDF Generator
byte[] pdfBytes = converter.GeneratePdf(html);

// IronPDF
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

// NReco PDF Generator
byte[] pdfBytes = converter.GeneratePdf(html);

// IronPDF
byte[] pdfBytes = renderer.RenderHtmlAsPdf(html).BinaryData;

' NReco PDF Generator
Dim pdfBytes As Byte() = converter.GeneratePdf(html)

' IronPDF
Dim pdfBytes As Byte() = renderer.RenderHtmlAsPdf(html).BinaryData

$vbLabelText $csharpLabel

问题 3：未找到 PageMargins 对象

问题：IronPDF中不存在 PageMargins 类。

解决方法：使用单独的边距属性：

// NReco PDF Generator
converter.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };

// IronPDF
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;

// NReco PDF Generator
converter.Margins = new PageMargins { Top = 10, Bottom = 10, Left = 10, Right = 10 };

// IronPDF
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;

' NReco PDF Generator
converter.Margins = New PageMargins With {.Top = 10, .Bottom = 10, .Left = 10, .Right = 10}

' IronPDF
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

$vbLabelText $csharpLabel

问题 4：页码未显示

问题： [page] 和 [topage] 占位符不起作用。

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

// NReco PDF Generator
converter.PageFooterHtml = "<div>Page [page] of [topage]</div>";

// IronPDF
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

// NReco PDF Generator
converter.PageFooterHtml = "<div>Page [page] of [topage]</div>";

// IronPDF
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

Imports NReco.PdfGenerator
Imports IronPdf

converter.PageFooterHtml = "<div>Page [page] of [topage]</div>"

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .HtmlFragment = "<div>Page {page} of {total-pages}</div>",
    .MaxHeight = 20
}

$vbLabelText $csharpLabel

迁移清单

迁移前

清点代码库中所有 NReco.PdfGenerator 的使用情况
记录所有 CustomWkHtmlArgs 和 CustomWkHtmlPageArgs 值列出所有带有占位符的页眉/页脚HTML模板
确定异步需求（Web 控制器、服务）
检查缩放和边距设置
备份现有 PDF 输出以进行比较
获取IronPDF许可证密钥

软件包变更

删除 NReco.PdfGenerator NuGet 包安装 IronPdf NuGet 包：dotnet add package IronPdf
将命名空间导入从 using NReco.PdfGenerator; 更新为 using IronPdf;

代码更改

在启动时添加许可证密钥配置
将 HtmlToPdfConverter 替换为 ChromePdfRenderer
将 GeneratePdf(html) 替换为 RenderHtmlAsPdf(html)
将 GeneratePdfFromFile(url, null) 替换为 RenderUrlAsPdf(url)
将 PageMargins 对象转换为单独的边距属性
将缩放值从浮点数更新为百分比
更新占位符语法：[page] → {page}，[topage] → {total-pages}
将 File.WriteAllBytes() 替换为 pdf.SaveAs()
在有利的情况下，将同步调用转换为异步调用。

后迁移

从项目/部署中移除 wkhtmltopdf 二进制文件
更新 Docker 文件以移除 wkhtmltopdf 安装
运行回归测试，比较 PDF 输出
验证页眉/页脚占位符是否正确渲染。
在所有目标平台（Windows、Linux、macOS）上进行测试
更新 CI/CD 流水线，移除 wkhtmltopdf 步骤
更新安全扫描以确认 CVE 已移除

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# 从 Nutrient.io 迁移到 IronPDF

如何用 C# 从 MuPDF 迁移到 IronPDF

立即开始30天免费试用

如何在 C# 中从 NReco PDF 生成器迁移到 IronPDF

为什么要从 NReco PDF 生成器迁移到 IronPDF?

NReco PDF 生成器的关键安全问题

NReco PDF 生成器的其他限制

NReco PDF 生成器与IronPDF的比较

开始之前

前提条件

NuGet 软件包变更

许可配置

确定 NReco PDF 生成器的用途

完整的 API 参考

核心类映射

渲染方法映射

页面配置映射

边距映射

页眉/页脚占位符映射

输出处理映射

代码迁移示例

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

示例 2：带边距的自定义页面大小

示例 3：URL 到 PDF 的转换

关键迁移说明

缩放值转换

占位符语法更新

返回类型更改

线程安全和可重用性

异步支持（新功能）

故障排除

问题 1：HtmlToPdfConverter 未找到

问题 2：GeneratePdf 返回错误类型

问题 3：未找到 PageMargins 对象

问题 4：页码未显示

迁移清单

迁移前

软件包变更

代码更改

后迁移

相关文章

如何用 C# 从 ZetPDF 迁移到 IronPDF

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

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

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

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

钢铁支援团队