跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. 迁移指南
  4. fo.net 迁移指南
迁移指南

如何从 fo.net 迁移到 IronPDF for .NET

Curtis Chau
Curtis Chau
已更新:

从 fo.net 迁移到 IronPDF：完整的 C# 迁移指南

从fo.net (FO.NET)迁移到IronPDF代表着您的 .NET PDF 生成工作流程的重大现代化。 本指南提供了一条清晰、循序渐进的迁移路径，可将您的代码库从过时的 XSL-FO 标记迁移到基于 HTML/CSS 的现代 PDF 生成，充分利用您的开发团队已经掌握的技能。

为什么要从 fo.net 迁移到 IronPDF．

fo.net 的挑战

fo.net 是一种 XSL-FO 到 PDF 的渲染器，对于现代开发而言有很大的局限性：

1.过时的技术：XSL-FO（可扩展样式表语言格式化对象）是 2001 年的 W3C 规范，自 2006 年以来没有更新过，基本上被认为是过时的技术。

2.学习曲线陡峭：XSL-FO 需要学习复杂的基于 XML 的标记和专门的格式化对象（fo:block、fo:table、fo:page-sequence 等）。

3.不支持 HTML/CSS：fo.net 无法呈现 HTML 或 CSS，需要手动将 HTML 转换为 XSL-FO 标记。

4.Abandoned/Unmaintained: CodePlex 的原始版本库已停用； GitHub 分叉已停止维护。

5.仅限 Windows：fo.net 对 System.Drawing 存在内部依赖关系，因此无法在 Linux/macOS 上运行。

6.有限的现代功能：不支持 JavaScript、不支持 CSS3、不支持 flexbox/grid、不支持现代网络字体。

7.无 URL 渲染：fo.net 无法直接渲染网页--需要手动将 HTML 转换为 XSL-FO。

fo.net 与IronPDF对比。

方面fo.net (FO.NET)IronPDF
输入格式XSL-FO（过时的 XML）HTML/CSS（现代网络标准）
学习曲线Steep （XSL-FO 专业技能）温柔（HTML/CSS 知识）
维护放弃每月积极维护
平台支持仅限 Windows真正的跨平台（.NET 6/7/8/9/10+）
CSS 支持无完整的 CSS3（Flexbox、网格）
JavaScript无完全支持 JavaScript
URL 渲染不支持内置
现代功能有限的页眉、页脚、水印、安全性
文档过时综合教程

为什么转换是有意义的

fo.net 是在 XSL-FO 可望成为文档格式化标准时设计的。 这一期望从未实现。 HTML/CSS 已成为通用文档格式，超过 98% 的开发人员了解 HTML/CSS，而了解 XSL-FO 的开发人员不到 1%。 大多数 XSL-FO 资源都是 2005-2010 年的，因此维护难度越来越大。

IronPDF 可让您使用已有的技能创建专业的 PDF，并完全支持现代 .NET 版本，包括 2025 年至 2026 年可用的 .NET 10 和 C# 14。

开始之前

前提条件

1..NET环境：IronPDF支持.NET Framework 4.6.2+、.NET Core 3.1+、.NET 5/6/7/8/9+。 2.NuGet访问：确保您可以从 NuGet 安装软件包 3.许可证密钥：从ironpdf.com获取用于生产的IronPDF许可证密钥。

备份您的项目

# Create a backup branch
git checkout -b pre-ironpdf-migration
git add .
git commit -m "Backup before fo.net toIronPDFmigration"
# Create a backup branch
git checkout -b pre-ironpdf-migration
git add .
git commit -m "Backup before fo.net toIronPDFmigration"
SHELL

识别所有 fo.net 使用情况

# Find all fo.net references
grep -r "FonetDriver\|Fonet\|\.fo\"\|xsl-region" --include="*.cs" --include="*.csproj" .

# Find all XSL-FO template files
find . -name "*.fo" -o -name "*.xslfo" -o -name "*xsl-fo*"
# Find all fo.net references
grep -r "FonetDriver\|Fonet\|\.fo\"\|xsl-region" --include="*.cs" --include="*.csproj" .

# Find all XSL-FO template files
find . -name "*.fo" -o -name "*.xslfo" -o -name "*xsl-fo*"
SHELL

记录您的 XSL-FO 模板

在迁移之前，将所有 XSL-FO 文件编目并注明：

  • 页面尺寸和页边距
  • 使用的字体
  • 表格及其结构
  • 页眉和页脚（<代码>fo:static-content</代码）
  • 页码模式
  • 图像引用

快速启动迁移

步骤 1：更新 NuGet 软件包

# Remove fo.net package
dotnet remove package Fonet
dotnet remove package FO.NET

# Install IronPDF
dotnet add package IronPdf
# Remove fo.net package
dotnet remove package Fonet
dotnet remove package FO.NET

# Install IronPDF
dotnet add package IronPdf
SHELL

步骤 2：更新命名空间

// Before (fo.net)
using Fonet;
using Fonet.Render.Pdf;
using System.Xml;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;
// Before (fo.net)
using Fonet;
using Fonet.Render.Pdf;
using System.Xml;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

第 3 步：初始化 IronPDF.

// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

步骤 4：基本转换模式

// Before (fo.net with XSL-FO)
FonetDriver driver = FonetDriver.Make();
using (FileStream output = new FileStream("output.pdf", FileMode.Create))
{
    driver.Render(new StringReader(xslFoContent), output);
}

// After (IronPDF with HTML)
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
// Before (fo.net with XSL-FO)
FonetDriver driver = FonetDriver.Make();
using (FileStream output = new FileStream("output.pdf", FileMode.Create))
{
    driver.Render(new StringReader(xslFoContent), output);
}

// After (IronPDF with HTML)
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

完整的 API 参考

命名空间映射

fo.net 命名空间IronPdf 同等产品备注
<代码>Fonet</代码<代码>IronPdf</代码主命名空间
<代码>Fonet.Render.Pdf</代码<代码>IronPdf</代码PDF 输出
<代码>Fonet.Layout</代码不适用使用 CSS 进行布局
<代码>Fonet.Fo</代码不适用格式化对象 → HTML
<代码>Fonet.Image</代码<代码>IronPdf</代码内置图像处理功能

FonetDriver 到 ChromePdfRenderer。

FonetDriver 方法IronPdf 同等产品备注
<代码>FonetDriver.Make()</代码<代码>new ChromePdfRenderer()</ 代码创建呈现器
<代码>driver.Render（inputStream, outputStream）</代码<代码>renderer.RenderHtmlAsPdf(html)</代码基于流
<代码>driver.Render（inputFile, outputStream）</代码<代码>renderer.RenderHtmlFileAsPdf(path)</代码基于文件
<代码>driver.BaseDirectory</代码<代码>RenderingOptions.BaseUrl</代码资源的基本路径
<代码>driver.OnError += 处理程序</代码围绕渲染的 Try/catch错误处理

渲染选项（PDF 配置）

fo.net（XSL-FO 属性）IronPdf 渲染选项备注
<代码>页面高度</代码<代码>PaperSize</代码>或<代码>SetCustomPaperSize()</代码页面尺寸
<代码>页面宽度</代码<代码>纸张大小</代码标准或定制
<代码>边框-顶部</代码<代码>页边距</代码单位：毫米
<代码>边距-底部</代码<代码>边距下限</代码单位：毫米
<代码>margin-left</代码<代码>边距左移</代码单位：毫米
<代码>右边距</代码<代码>MarginRight</代码单位：毫米
<代码>参考-导向</代码<代码>文件方向</代码肖像/风景

XSL-FO 到 HTML 转换指南

将 XSL-FO 元素转换为 HTML/CSS.

这次 fo.net 迁移的基本转变是将 XSL-FO 元素转换为 HTML 对应元素：

XSL-FO 元素HTML/CSS 同等内容备注
<代码></代码<html>根元素
<代码><fo:布局主集></代码CSS @page 规则页面设置
<代码></代码CSS @page页面定义
<代码></代码<body> 或 <div>页面内容
<代码><fo:流程></代码<main> 或 <div>主要内容
<代码><fo:静态内容></代码<代码>HtmlHeaderFooter</代码页眉/页脚
<代码><fo:块></代码<p>, <div>, <h1>-<h6>区块内容
<代码></代码<代码></代码内联内容
<代码><fo:表格></代码<table>表格
<代码></代码<tr>表格行数
<代码></代码<代码></代码>, <代码></代码表格单元格
<代码></代码<代码>
    </代码>, <代码>
      </代码
清单
<代码></代码<li>列表项目
<代码><fo:外部图形></代码<img>图片
<代码><fo:页码></代码{page} 占位符页码
<代码><fo:页码-引文></代码<代码>{总页数}</代码总页数
<代码></代码<a href>超链接

将 XSL-FO 属性转换为 CSS.

XSL-FO 属性等效 CSS范例
<代码>字体</代码<代码>字体</代码相同语法
<代码>字体大小</代码<代码>字体大小</代码相同语法
<代码>字体大小</代码<代码>字体大小</代码<代码>粗体</代码>, <代码>正常</代码>, <代码>700</代码
<代码>文本对齐</代码<代码>文本对齐</代码<代码>左</代码>, <代码>居中</代码>, <代码>右</代码>, <代码>justify</代码
<代码>颜色</代码<代码>颜色</代码十六进制、RGB、名称
<代码>背景颜色</代码<代码>背景颜色</代码相同语法
<代码>space-before</代码<代码>边框-顶部</代码元素前
<代码>后空</代码<代码>边距-底部</代码要素之后
<代码>start-indent</代码<代码>margin-left</代码左缩进
<代码>保持一致</代码<代码>page-break-inside:避免</代码防止断句
<代码>break-before="page"</代码<代码>page-break-before:始终</代码强制分页

代码示例

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

之前（使用 XSL-FO 的 fo.net）：

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;
using System.Xml;

class Program
{
    static void Main()
    {
        // fo.net requires XSL-FO format, not HTML
        // First convert HTML to XSL-FO (manual process)
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='page'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='page'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block>Hello World</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("output.pdf", FileMode.Create));
    }
}
// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;
using System.Xml;

class Program
{
    static void Main()
    {
        // fo.net requires XSL-FO format, not HTML
        // First convert HTML to XSL-FO (manual process)
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='page'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='page'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block>Hello World</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("output.pdf", FileMode.Create));
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

译文（IronPDF 与 HTML）：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is HTML content.</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string html = "<h1>Hello World</h1><p>This is HTML content.</p>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPdf 方法将 25 行以上的 XSL-FO 标记减少到仅 4 行简洁的 C# 代码。 有关 HTML 转 PDF 的更多选项，请参阅 IronPDF HTML 转 PDF 文档。

示例 2：带有自定义设置的 PDF 文件

之前（使用 XSL-FO 的 fo.net）：

// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // fo.net settings are configured in XSL-FO markup
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("custom.pdf", FileMode.Create));
    }
}
// NuGet: Install-Package Fonet
using Fonet;
using Fonet.Render.Pdf;
using System.IO;

class Program
{
    static void Main()
    {
        // fo.net settings are configured in XSL-FO markup
        string xslFo = @"<?xml version='1.0' encoding='utf-8'?>
            <fo:root xmlns:fo='http://www.w3.org/1999/XSL/Format'>
                <fo:layout-master-set>
                    <fo:simple-page-master master-name='A4' 
                        page-height='297mm' page-width='210mm'
                        margin-top='20mm' margin-bottom='20mm'
                        margin-left='25mm' margin-right='25mm'>
                        <fo:region-body/>
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference='A4'>
                    <fo:flow flow-name='xsl-region-body'>
                        <fo:block font-size='14pt'>Custom PDF</fo:block>
                    </fo:flow>
                </fo:page-sequence>
            </fo:root>";

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("custom.pdf", FileMode.Create));
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

译文（IronPDF 与 HTML）：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 25;
        renderer.RenderingOptions.MarginRight = 25;

        string html = "<h1 style='font-size:14pt'>Custom PDF</h1>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 25;
        renderer.RenderingOptions.MarginRight = 25;

        string html = "<h1 style='font-size:14pt'>Custom PDF</h1>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("custom.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPdf 提供编程式渲染选项，而不是在 XML 标记中嵌入配置。

示例 3：URL 转 PDF.

之前（不支持 fo.net）：

// NuGet: Install-Package Fonet
using Fonet;
using System.IO;
using System.Net;

class Program
{
    static void Main()
    {
        // fo.net does not support URL rendering directly
        // Must manually download, convert HTML to XSL-FO, then render
        string url = "https://example.com";
        string html = new WebClient().DownloadString(url);

        // Manual conversion from HTML to XSL-FO required (complex)
        string xslFo = ConvertHtmlToXslFo(html); // Not built-in

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("webpage.pdf", FileMode.Create));
    }

    static string ConvertHtmlToXslFo(string html)
    {
        // Custom implementation required - extremely complex
        throw new System.NotImplementedException();
    }
}
// NuGet: Install-Package Fonet
using Fonet;
using System.IO;
using System.Net;

class Program
{
    static void Main()
    {
        // fo.net does not support URL rendering directly
        // Must manually download, convert HTML to XSL-FO, then render
        string url = "https://example.com";
        string html = new WebClient().DownloadString(url);

        // Manual conversion from HTML to XSL-FO required (complex)
        string xslFo = ConvertHtmlToXslFo(html); // Not built-in

        FonetDriver driver = FonetDriver.Make();
        driver.Render(new StringReader(xslFo), 
            new FileStream("webpage.pdf", FileMode.Create));
    }

    static string ConvertHtmlToXslFo(string html)
    {
        // Custom implementation required - extremely complex
        throw new System.NotImplementedException();
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

后（IronPDF - 内置支持）：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://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://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

URL 到 PDF 的渲染是此次 fo.net 迁移的最大优势之一。IronPDF可通过完整的JavaScript执行来处理这些问题。 了解有关 URL 至 PDF 转换的更多信息。

示例 4：页眉和页脚

之前（使用 XSL-FO 的 fo.net）：

<fo:static-content flow-name="xsl-region-before">
    <fo:block text-align="center" font-size="10pt">
        Company Name - Confidential
    </fo:block>
</fo:static-content>

<fo:static-content flow-name="xsl-region-after">
    <fo:block text-align="right" font-size="10pt">
        Page <fo:page-number/> of <fo:page-number-citation ref-id="last-page"/>
    </fo:block>
</fo:static-content>
<fo:static-content flow-name="xsl-region-before">
    <fo:block text-align="center" font-size="10pt">
        Company Name - Confidential
    </fo:block>
</fo:static-content>

<fo:static-content flow-name="xsl-region-after">
    <fo:block text-align="right" font-size="10pt">
        Page <fo:page-number/> of <fo:page-number-citation ref-id="last-page"/>
    </fo:block>
</fo:static-content>
XML

After (IronPDF)：

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    DrawDividerLine = true
};
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
    DrawDividerLine = true
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
    DrawDividerLine = true
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPdf 将复杂的 XSL-FO 区域定义替换为简单的 HTML 页眉和页脚。

示例 5：PDF 安全性

之前（fo.net）：

// fo.net has very limited PDF security options
// Must use post-processing with another library
// fo.net has very limited PDF security options
// Must use post-processing with another library
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

After (IronPDF)：

using IronPdf;

public byte[] GenerateSecurePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Set metadata
    pdf.MetaData.Title = "Confidential Report";
    pdf.MetaData.Author = "Company Name";

    // Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123";
    pdf.SecuritySettings.UserPassword = "user456";

    // Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

    return pdf.BinaryData;
}
using IronPdf;

public byte[] GenerateSecurePdf(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html);

    // Set metadata
    pdf.MetaData.Title = "Confidential Report";
    pdf.MetaData.Author = "Company Name";

    // Password protection
    pdf.SecuritySettings.OwnerPassword = "owner123";
    pdf.SecuritySettings.UserPassword = "user456";

    // Restrict permissions
    pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
    pdf.SecuritySettings.AllowUserEdits = IronPdf.Security.PdfEditSecurity.NoEdit;

    return pdf.BinaryData;
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

性能考虑

重用 ChromePdfRenderer。

为了在迁移 fo.net 时获得最佳性能，请重复使用 ChromePdfRenderer 实例：

// GOOD - Reuse the renderer
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creating new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}
// GOOD - Reuse the renderer
public class PdfService
{
    private static readonly ChromePdfRenderer _renderer = new ChromePdfRenderer();

    public byte[] Generate(string html) => _renderer.RenderHtmlAsPdf(html).BinaryData;
}

// BAD - Creating new instance each time
public byte[] GenerateBad(string html)
{
    var renderer = new ChromePdfRenderer();  // Wasteful
    return renderer.RenderHtmlAsPdf(html).BinaryData;
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

单元转换助手

fo.net XSL-FO 使用多种单位。 IronPdf 使用毫米作为页边距。 这里有一个辅助类：

public static class UnitConverter
{
    public static double InchesToMm(double inches) => inches * 25.4;
    public static double PointsToMm(double points) => points * 0.352778;
    public static double PicasToMm(double picas) => picas * 4.233;
    public static double CmToMm(double cm) => cm * 10;
}

// Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1);  // 1 inch
public static class UnitConverter
{
    public static double InchesToMm(double inches) => inches * 25.4;
    public static double PointsToMm(double points) => points * 0.352778;
    public static double PicasToMm(double picas) => picas * 4.233;
    public static double CmToMm(double cm) => cm * 10;
}

// Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1);  // 1 inch
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

故障排除

问题 1：页面大小差异

问题：迁移 fo.net 后，PDF 页面大小看起来不同。

解决方案：正确映射 XSL-FO 页面尺寸：

// XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;

// XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297);
// XSL-FO: page-height='11in' page-width='8.5in' (Letter)
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;

// XSL-FO: page-height='297mm' page-width='210mm' (A4)
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// Custom size (in mm)
renderer.RenderingOptions.SetCustomPaperSize(210, 297);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

问题 2：fo:block 到 HTML 映射

问题：不确定<代码><fo:块></代码应该变成什么。

解决方案：使用适当的语义 HTML：

  • 标题：<代码>

    </代码>至<代码>

    </代码
  • 段落：<代码>

    </代码

  • 通用容器：<div>
  • 内联文本：<代码></代码

问题 3：字体不匹配

问题：字体看起来与 fo.net 输出不同。

解决方案：使用网络字体或在 CSS 中指定系统字体：

<style>
    @import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
    body { font-family: 'Roboto', Arial, sans-serif; }
</style>
<style>
    @import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
    body { font-family: 'Roboto', Arial, sans-serif; }
</style>
HTML

问题 4：页码不起作用

问题：<fo:page-number/> 不工作。

解决方案：在页眉/页脚中使用IronPDF占位符：

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 15  // mm
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 15  // mm
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

迁移清单

迁移前

  • [ ] 编目所有 XSL-FO 模板文件（.fo、.xslfo</code）
  • [使用的文档页面尺寸和页边距
  • [ ] 注意页眉/页脚配置 (fo:static-content)
  • [ ] 确定表格结构和样式
  • [将项目备份到版本控制中
  • [ ] 获取 IronPdf 许可证密钥

软件包迁移

  • [ ] 删除<代码>Fonet</代码或 FO.NET 软件包：<代码>dotnet 删除软件包 Fonet</代码
  • [ ] 安装<代码>IronPdf</代码软件包：<代码>dotnet 添加软件包 IronPdf
  • [ ] 将名称空间导入从<代码>Fonet</代码更新为 IronPdf
  • [ ] 在启动时设置 IronPdf 许可证密钥

代码迁移

  • [ ] 将<代码>FonetDriver.Make()</代码替换为<代码>new ChromePdfRenderer()</ 代码。
  • [将 driver.Render() 替换为 renderer.RenderHtmlAsPdf() 。
  • [ ] 将文件输出从流更新为 pdf.SaveAs()
  • [ ] 使用 try/catch 替换错误事件处理程序
  • [ ] 将 fo:static-content 转换为 HtmlHeaderFooter
  • [ ] 将 <fo:page-number/> 替换为 {page} 占位符

测试

  • [ ] 将输出外观与原始 fo.net PDF 进行比较
  • [ ] 核实页面尺寸和页边距
  • [ ] 检查页眉和页脚
  • [ ] 验证页码
  • [ ] 测试表格渲染
  • [ ] 验证图片加载

后迁移

  • [ ] 删除 .fo 和 .xslfo 模板文件
  • [ ] 删除与 fo.net 相关的代码和实用程序
  • [ ] 更新文档

结论

从 fo.net 迁移到IronPDF可以用 98% 以上的开发人员已经掌握的 HTML/CSS 技能取代过时的 XSL-FO 标记，从而使您的 .NET PDF 生成工作流程现代化。 此次迁移消除了对废弃库的依赖，增加了跨平台支持，并提供了对JavaScript渲染、CSS3 风格和全面 PDF 安全性等现代功能的访问。

IronPDF 的积极维护确保了与当前和未来 .NET 版本的兼容性，包括 .NET 10 及更高版本。 有关其他指导，请浏览完整的 IronPDF 文档和 API 参考。

准备好开始您的 fo.net 迁移了吗？ 下载 IronPDF 并立即开始将您的第一个 XSL-FO 模板转换为 HTML。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

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

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

相关文章

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