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

素颜马尾好姑娘i 2024-05-01 03:00 102阅读 0赞

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

#### **HTML转PDF所需工具：** ####

1. **Spire.PDF for .NET**

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

2. **Qt WebEngine**

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

*  [Windows x86][]
 *  [Windows x64][]
 *  [Linux x64][]
 *  [Mac x64][]

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

步骤：

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

C\# 代码：

using Spire.Pdf.Graphics;
    using Spire.Additions.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 ###

步骤：

1.  通过File.ReadAllText() 方法从一个 html文件中读取字符串；
2.  指定生成文件和QT插件路径；
3.  调用**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.Additions.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);
            }
        }
    }

> ***请注意：**只有内联 CSS 样式和内部 CSS 样式可以在 PDF 上正确呈现。如果是外部 CSS 样式，需要先将其转换为内联或内部 CSS 样式。*

**总结：**通过以上两个简单的C\#示例代码，我们可以实现HTML网页转PDF，或HTML字符串转PDF。Spire.PDF for .NET库也支持在不使用插件的情况下将HTML转为PDF，但借助QT插件可以实现更好的渲染效果。

--------------------

*参考：*

*[C\#/VB.NET 将 HTML 转换为 PDF][C_VB.NET _ HTML _ PDF]*

*[Spire.PDF for .NET 各功能中文教程][Spire.PDF for .NET 1]*

[Spire.PDF for .NET]: https://www.e-iceblue.cn/Introduce/Spire-PDF-NET.html
[Link 1]: https://www.e-iceblue.cn/Downloads/Spire-PDF-NET.html
[nuget]: http://www.nuget.org/packages/Spire.PDF/
[Windows x86]: https://www.e-iceblue.com/downloads/plugins/plugins-windows-x86.zip
[Windows x64]: https://www.e-iceblue.com/downloads/plugins/plugins-windows-x64.zip
[Linux x64]: https://www.e-iceblue.com/downloads/plugins/net/plugins-linux-x64.tar.gz
[Mac x64]: https://www.e-iceblue.com/downloads/plugins/net/plugins-macosx-x64.zip
[C_VB.NET _ HTML _ PDF]: https://www.e-iceblue.cn/conversion/convert-html-into-pdf.html
[Spire.PDF for .NET 1]: https://www.e-iceblue.cn/spirepdfnet/spire-pdf-for-net-program-guide-content.html