优秀的编程知识分享平台

网站首页 > 技术文章 正文

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

nanyue 2025-04-30 18:37:05 技术文章 53 ℃

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

5.2 CSS 样式不生效

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

解决方案：

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

5.3 图片无法加载

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

解决方案：

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

6. 总结

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

Tags：

猜你喜欢

最近发表
标签列表