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

郑子铭

发布于 2025-06-07 13:58:26

53900

代码可运行

文章被收录于专栏：DotNet NB && CloudNativeDotNet NB && CloudNative

运行总次数：0

代码可运行

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)));