已更新 2026年7月19日
如何在 .NET 10 中用 C# 将 HTML 转换为 PDF | IronPDF for .NET
本视频教程将指导您使用 IronPDF for .NET 直接从 HTML 生成高质量 PDF 文档。您将了解 IronPDF 如何有效地渲染 HTML、CSS 和图像，从而轻松高效地生成专业 PDF。
阅读更多
视频
如何使用C#实现自定义日志记录
Curtis Chau
Updated: 2026年7月19日
从fo.net (FO.NET)迁移到IronPDF是 .NET PDF 生成流程的一次重大更新。 本指南提供了一条简单明了的分步路径，帮助您利用开发团队已有的技能，将代码库从过时的 XSL-FO 标记过渡到现代的基于 HTML/CSS 的 PDF 生成。
为什么要从 fo.net 迁移到 IronPDF．
fo.net 的挑战
fo.net (FO.NET) 是早期 Apache FOP 构建的 C# 移植，它将 XSL-FO 文档转换为 PDF。 它是 Apache 2.0 许可的，但对于当前开发有几个限制：
-
过时的技术： XSL-FO (Extensible Stylesheet Language Formatting Objects) 是 2001 年的 W3C 规范； W3C 在 2013 年关闭了 XSL-FO 工作组，语言没有进一步发展。
-
**复杂的学习曲线：**XSL-FO需要复杂的基于XML的标记和专用的格式化对象（
fo:page-sequence等）。 -
不支持 HTML/CSS： fo.net 不能渲染 HTML 或 CSS——您必须自行将 HTML 转换为 XSL-FO（通常通过 XSLT）。
-
**已弃用/无人维护：**nuget.org上的
Fonet包最后一次发布是在2011年4月（v1.0.0，.NET Framework 2.0）。 社区forkFonet.Standard(.NET Standard 2.0) 最后一次发布是在2020年5月 (v1.0.5)。 CodePlex代码库已失效，而GitHub的forks（hahmed/Fo.Net）处于休眠状态。 -
**实际上仅限于Windows：**旧版
System.Drawing(GDI+) APIs，这实际上将其限制在Windows上运行。 -
现代功能有限： 无JavaScript引擎，无法使用 CSS3（flexbox/grid），以及现代 Web 字体加载。
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 知识） |
| 维护 | 已弃用（最后发布于 2020 年 5 月） | 积极维护 |
| 平台支持 | 仅限 Windows | 跨平台 (.NET Framework 4.6.2+，.NET Core 3.1+，.NET 5/6/7/8/9+) |
| CSS 支持 | None | 完整的 CSS3（Flexbox、网格） |
| JavaScript | None | 完全支持 JavaScript |
| URL 渲染 | 不支持 | 内置 |
| 现代功能 | 有限的 | 页眉、页脚、水印、安全性 |
| 文档 | 过时 | 详尽的教程 |
为什么转换是有意义的
fo.net 是在 XSL-FO 可望成为文档格式化标准时设计的。 这一期望从未实现。 HTML/CSS 成为通用的文档格式，而 XSL-FO 仍然是一种小众技能——大多数 XSL-FO 资源始于 2005–2010 年，维护起来越来越困难。
IronPDF 让您可以利用已有的技能，在现代 .NET 上创建专业 PDF。
开始之前
前提条件
- **.NET 环境：**IronPDF支持 .NET Framework 4.6.2+、.NET Core 3.1+ 和 .NET 5/6/7/8/9+。
- **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"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*"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 IronPdfSHELL
步骤 2：更新命名空间
// Before (fo.net)
using Fonet;
using Fonet.Render.Pdf;
using System.Xml;
// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;Imports IronPdf
Imports IronPdf.Rendering第 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"步骤 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");Imports System.IO
Imports Fonet
Imports IronPdf
' Before (fo.net with XSL-FO)
Dim driver As FonetDriver = FonetDriver.Make()
Using output As FileStream = New FileStream("output.pdf", FileMode.Create)
driver.Render(New StringReader(xslFoContent), output)
End Using
' After (IronPDF with HTML)
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")完整的 API 参考
命名空间映射
| fo.net 命名空间 | IronPDF 同等产品 |
|---|---|
Fonet | IronPdf |
Fonet.Render.Pdf | IronPdf |
Fonet.Layout | 不适用 |
Fonet.Fo | 不适用 |
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 += handler | 围绕渲染的 Try/catch |
渲染选项（PDF 配置）
| fo.net（XSL-FO 属性） | IronPDF 渲染选项 |
|---|---|
page-height | PaperSize 或 SetCustomPaperSize() |
page-width | PaperSize |
margin-top | MarginTop |
margin-bottom | MarginBottom |
margin-left | MarginLeft |
margin-right | MarginRight |
reference-orientation | PaperOrientation |
XSL-FO 到 HTML 转换指南
将 XSL-FO 元素转换为 HTML/CSS.
这次 fo.net 迁移的基本转变是将 XSL-FO 元素转换为 HTML 对应元素：
| XSL-FO 元素 | HTML/CSS 同等内容 |
|---|---|
<fo:root> | <html> |
<fo:layout-master-set> | CSS @page 规则 |
<fo:simple-page-master> | CSS @page |
<fo:page-sequence> | <body> 或 <div> |
<fo:flow> | <main> 或 <div> |
<fo:static-content> | HtmlHeaderFooter |
<fo:block> | <p>, <div>, <h1>-<h6> |
<fo:inline> | <span> |
<fo:table> | <table> |
<fo:table-row> | <tr> |
<fo:table-cell> | <td>, <th> |
<fo:list-block> | <ul>, <ol> |
<fo:list-item> | <li> |
<fo:external-graphic> | <img> |
<fo:page-number> | {page} 占位符 |
<fo:page-number-citation> | {total-pages} |
<fo:basic-link> | <a href> |
将 XSL-FO 属性转换为 CSS.
| XSL-FO 属性 | 等效 CSS | 范例 |
|---|---|---|
font-family | font-family | 相同语法 |
font-size | font-size | 相同语法 |
font-weight | font-weight | bold, normal, 700 |
text-align | text-align | left, center, right, justify |
color | color | 十六进制、RGB、名称 |
background-color | background-color | 相同语法 |
space-before | margin-top | 元素前 |
space-after | margin-bottom | 要素之后 |
start-indent | margin-left | 左缩进 |
keep-together | page-break-inside: avoid | 防止断句 |
break-before="page" | page-break-before: always | 强制分页 |
代码示例
示例 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
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO
Imports System.Xml
Class Program
Shared Sub Main()
' fo.net requires XSL-FO format, not HTML
' First convert HTML to XSL-FO (manual process)
Dim xslFo As String = "<?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>"
Dim driver As FonetDriver = FonetDriver.Make()
driver.Render(New StringReader(xslFo),
New FileStream("output.pdf", FileMode.Create))
End Sub
End Class译文（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");
}
}Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim html As String = "<h1>Hello World</h1><p>This is HTML content.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
End Sub
End ClassIronPDF 方法将 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
Imports Fonet
Imports Fonet.Render.Pdf
Imports System.IO
Class Program
Shared Sub Main()
' fo.net settings are configured in XSL-FO markup
Dim xslFo As String = "<?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>"
Dim driver As FonetDriver = FonetDriver.Make()
driver.Render(New StringReader(xslFo),
New FileStream("custom.pdf", FileMode.Create))
End Sub
End Class译文（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
Imports IronPdf
Imports IronPdf.Engines.Chrome
Module Program
Sub Main()
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20
renderer.RenderingOptions.MarginLeft = 25
renderer.RenderingOptions.MarginRight = 25
Dim html As String = "<h1 style='font-size:14pt'>Custom PDF</h1>"
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("custom.pdf")
End Sub
End ModuleIronPDF 提供编程式渲染选项，而不是在 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
Imports Fonet
Imports System.IO
Imports System.Net
Class Program
Shared Sub Main()
' fo.net does not support URL rendering directly
' Must manually download, convert HTML to XSL-FO, then render
Dim url As String = "https://example.com"
Dim html As String = New WebClient().DownloadString(url)
' Manual conversion from HTML to XSL-FO required (complex)
Dim xslFo As String = ConvertHtmlToXslFo(html) ' Not built-in
Dim driver As FonetDriver = FonetDriver.Make()
driver.Render(New StringReader(xslFo),
New FileStream("webpage.pdf", FileMode.Create))
End Sub
Shared Function ConvertHtmlToXslFo(html As String) As String
' Custom implementation required - extremely complex
Throw New System.NotImplementedException()
End Function
End Class后（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");
}
}Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
End Sub
End Class将 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>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
};Imports System
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='text-align:center; font-size:10pt;'>Company Name - Confidential</div>",
.DrawDividerLine = True
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='text-align:right; font-size:10pt;'>Page {page} of {total-pages}</div>",
.DrawDividerLine = True
}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 libraryAfter (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;
}Imports IronPdf
Public Function GenerateSecurePdf(html As String) As Byte()
Dim renderer = New ChromePdfRenderer()
Dim 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
End Function性能考虑
重用 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;
}Imports System
' GOOD - Reuse the renderer
Public Class PdfService
Private Shared ReadOnly _renderer As New ChromePdfRenderer()
Public Function Generate(html As String) As Byte()
Return _renderer.RenderHtmlAsPdf(html).BinaryData
End Function
End Class
' BAD - Creating new instance each time
Public Function GenerateBad(html As String) As Byte()
Dim renderer As New ChromePdfRenderer() ' Wasteful
Return renderer.RenderHtmlAsPdf(html).BinaryData
End Function单元转换助手
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 inchPublic Module UnitConverter
Public Function InchesToMm(inches As Double) As Double
Return inches * 25.4
End Function
Public Function PointsToMm(points As Double) As Double
Return points * 0.352778
End Function
Public Function PicasToMm(picas As Double) As Double
Return picas * 4.233
End Function
Public Function CmToMm(cm As Double) As Double
Return cm * 10
End Function
End Module
' Usage
renderer.RenderingOptions.MarginTop = UnitConverter.InchesToMm(1) ' 1 inch故障排除
问题 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)问题 2：fo:block 到 HTML 映射
**问题：**不确定<fo:block>应该变成什么。
**解决方案：**使用合适的语义化 HTML：
- 标题：
<h1>到<h6> - 段落：
<p> - 通用容器：
<div> - 内联文本：
<span>
问题 3：字体不匹配
**问题：**字体与 fo.net 输出的字体看起来不一样。
**解决方案：**使用网页字体或在 CSS 中指定系统字体：
<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
};Imports System
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
.MaxHeight = 15 ' mm
}迁移清单
迁移前
- 记录所有XSL-FO模板文件（
.xslfo） - 文档页面尺寸和边距
- 注意页眉/页脚配置（
fo:static-content） - 确定表格结构和样式
- 将项目备份到版本控制系统
- 获取IronPDF许可证密钥
软件包迁移
- 移除
dotnet remove package Fonet - 安装
dotnet add package IronPdf - 将命名空间导入从
IronPdf - 在启动时设置IronPDF许可证密钥
代码迁移
- 将
new ChromePdfRenderer() - 将
renderer.RenderHtmlAsPdf() - 将文件输出从流更新为
pdf.SaveAs() - 将错误事件处理程序替换为 try/catch
- 转换
HtmlHeaderFooter - 将
{page}占位符
测试
- 将输出外观与原始 fo.net PDF 进行比较
- 检查页面尺寸和边距。
- 检查页眉和页脚
- 验证页码
- 测试表格渲染
- 验证图像加载情况
后迁移
- 删除
.xslfo模板文件 - 移除与 fo.net 相关的代码和实用程序
- 更新文档
有关上面使用的IronPDF功能的更详细介绍，请参阅 IronPDF API 参考。
请注意: FO.NET、Fonet 和 Apache FOP 是其各自所有者的商标。 本网站与 FO.NET 项目或 Apache Software Foundation 无关，不被其认可或赞助。 所有产品名称、徽标和品牌均为各自所有者的财产。 比较仅供参考，反映撰写时公开可用的信息。
技术作家
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多相关文章
当您需要PDF看起来像HTML时，速度快。
