C# 将HTML网页、HTML字符串转换为PDF文件

news2024/12/26 22:14:52

将HTML转换为PDF可实现格式保留、可靠打印、文档归档等多种用途，满足不同领域和情境下的需求。本文将通过以下两个示例，演示如何使用第三方库Spire.PDF for .NET和QT插件在C# 中将Html 网页（URL）或HTML字符串转为PDF文件。

HTML转PDF所需工具：

1. Spire.PDF for .NET

首先需要安装Spire.PDF for .NET到你的项目中，可以官网下载后手动引入，或通过nuget安装。

2. Qt WebEngine

用到QT插件为Qt WebEngine，以下是各操作系统对应的插件包，可点击直接下载，然后解压缩到指定路径。

Windows x86
Windows x64
Linux x64
Mac x64

示例一：使用QT插件将Html 网页（URL）转为PDF

步骤：

指定要转换的URL地址、生成文件路径和QT插件路径；
调用 HtmlConverter.Convert(string url, string fileName, bool enableJavaScript, int timeout, SizeF pageSize, PdfMargins margins) 方法来转换 URL 为 PDF 文件。

C# 代码：

using Spire.Pdf.Graphics;
using Spire.Pdf.HtmlConverter.Qt;
using System.Drawing;

namespace ConvertUrlToPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            //指定网页URL地址
            string url = "https://www.baidu.com/";

            //指定输出文件路径
            string fileName = "Url转Pdf.pdf";

            //指定插件路径
            string pluginPath = "F:\\plugins-windows-x64\\plugins";

            //设置插件路径
            HtmlConverter.PluginPath = pluginPath;

            //将HTML网页转换为PDF
            HtmlConverter.Convert(url, fileName, true, 100000, new Size(1080, 1000), new PdfMargins(0));
        }
    }
}

转换百度首页的效果图：

示例二：使用QT插件将Html 字符串转为PDF

步骤：

通过File.ReadAllText() 方法从一个 html文件中读取字符串；
指定生成文件和QT插件路径；
调用 HtmlConverter.Convert(string htmlString, string fileName, bool enableJavaScript, int timeout, SizeF pageSize, PdfMargins margins, Spire.Pdf.HtmlConverter.LoadHtmlType htmlType) 方法将 HTML 字符串转换为 PDF 文件。

C# 代码：

using System.IO;
using Spire.Pdf.HtmlConverter.Qt;
using System.Drawing;
using Spire.Pdf.Graphics;

namespace ConvertHtmlStringToPdfWithPlugin
{
    class Program
    {
        static void Main(string[] args)
        {
            //从.html文件中获取HTML字符串
            string htmlString = File.ReadAllText("示例.html");

            //指定输出文件路径
            string fileName = "Html字符串转Pdf.pdf";

            //指定插件路径
            string pluginPath = "F:\\plugins-windows-x64\\plugins";

            //设置插件
            HtmlConverter.PluginPath = pluginPath;

            //将HTML字符串转换为PDF
            HtmlConverter.Convert(htmlString, fileName, true, 100000, new Size(1080, 1000), new PdfMargins(0), Spire.Pdf.HtmlConverter.LoadHtmlType.SourceCode);
        }
    }
}