C# 使用 iText7 实现 HTML 转 PDF 指南

moboyou 2025-06-13 07:56 35 浏览

1. 引言

在现代 Web 开发中，将 HTML 转换为 PDF 是一个常见的需求，例如生成发票、报告或合同等文档。iText7 是一个功能强大的 PDF 操作库，支持多种 PDF 操作，包括将 HTML 转换为 PDF。通过 iText7 的 pdfHTML 扩展模块，可以轻松实现 HTML 到 PDF 的高质量转换。

本文将详细介绍如何在 C# 中使用 iText7 将 HTML 转换为 PDF，并提供代码示例和注意事项。

2. 环境准备

2.1 安装 NuGet 包

在项目中添加 iText7 和 pdfHTML 的 NuGet 包：

dotnet add package itext7 --version 9.1.0
dotnet add package itext7.pdfhtml --version 4.0.6

3. 将 HTML 转换为 PDF

3.1 从 HTML 文件生成 PDF

//输入 HTML 文件路径
using iText.Html2pdf.Resolver.Font;
using iText.Html2pdf;

string htmlFilePath = "table.html";
// 输出 PDF 文件路径
string pdfFilePath = "tableoutput.pdf";

// 将 HTML 文件转换为 PDF
HtmlConverter.ConvertToPdf(new FileStream(htmlFilePath, FileMode.Open), new FileStream(pdfFilePath, FileMode.Create), new ConverterProperties().SetFontProvider(new DefaultFontProvider(true, true, true)));
//公众号：net分享
Console.WriteLine("HTML 文件已成功转换为 PDF");

3.2 从 HTML 字符串生成 PDF// HTML 字符串
using iText.Html2pdf.Resolver.Font;
using iText.Html2pdf;

string htmlContent = @"
<html>
<head>
<title>Net 分享</title>
</head>
<body>
<h1></h1>
<h1>Net 分享</h1>
<p>欢迎使用 iText7-一个 HTML 转 PDF </p>
</body>
</html>";

// 输出 PDF 文件路径
string pdfFilePath = "output_from_string.pdf";

HtmlConverter.ConvertToPdf(htmlContent, new FileStream(pdfFilePath, FileMode.Create), new ConverterProperties().SetFontProvider(new DefaultFontProvider(true, true, true)));

// 将 HTML 字符串转换为 PDF
//HtmlConverter.ConvertToPdf(htmlContent, new FileStream(pdfFilePath, FileMode.Create));

Console.WriteLine("HTML 字符串已成功转换为 PDF");

5. 常见问题及解决方案

5.1 字体显示问题

问题描述：生成的 PDF 文件中，中文或其他非拉丁字符显示为乱码。

解决方案：

1. 安装 iText7 的字体支持包：dotnet add package itext7.font-asian
2. 在代码中指定支持中文的字体：HtmlConverter.ConvertToPdf(htmlContent, new FileStream(pdfFilePath, FileMode.Create), new ConverterProperties().SetFontProvider(new DefaultFontProvider(true, true, true)));

5.2 CSS 样式不生效

问题描述：生成的 PDF 文件中，HTML 的样式未正确应用。

解决方案：

1. 确保 HTML 文件中正确引用了 CSS 文件。
2. 如果使用外部 CSS 文件，确保文件路径正确且可访问。

5.3 图片无法加载

问题描述：PDF 文件中未显示 HTML 中的图片。

解决方案：

1. 确保图片路径正确，使用绝对路径或 URL。
2. 如果图片是本地文件，建议使用绝对路径或将图片嵌入 HTML 中。

6. 总结

通过本文的介绍，您可以使用 iText7 在 C# 中轻松实现 HTML 到 PDF 的转换。iText7 提供了强大的功能，适用于各种复杂的 PDF 生成场景。可以高效地将满足各种业务需求。

css教程pdf下载

上一篇：NetCore实战:基于html生成pdf文件案例讲解
下一篇：css样式引入优先级?

C# 使用 iText7 实现 HTML 转 PDF 指南

1. 引言

2. 环境准备

2.1 安装 NuGet 包

3. 将 HTML 转换为 PDF

3.1 从 HTML 文件生成 PDF

5. 常见问题及解决方案

5.1 字体显示问题

5.2 CSS 样式不生效

5.3 图片无法加载

6. 总结

相关推荐

Linux环境中查看Oracle错误和警告日志信息

絮语----工作四年的碎碎念

SQL 中的 (+)用法

oracle常见问题处理

MYSQL经典面试题汇总

医院信息系统突发应急演练记录

Windows 11:已知问题和已解决问题列表(更新时间:2022年1月)

最全面的IBMS系统集成系统技术规格书，赶紧收藏起来!

苹果停止更新Windows版QuickTime!

Linux下开源BI工具Metabase本地化安装及配置详解