将 HTML 内容转换为 PDF 有很多好处，可以离线阅读 HTML 内容，也可以高保真地保存 HTML 内容和格式。Spire.PDF 提供两种方法将 HTML 转换为 PDF，一种使用 QT Web 插件进行转换，另一种则不需要插件。使用 QT 插件来转换是比较推荐的转换方法。
以下内容展示了如何使用 Spire.PDF for .NET 在有或没有 QT 插件的情况下将 HTML 网页（URL）或 HTML 字符串渲染成 PDF 文档。
安装 Spire.PDF for .NET
首先，我们需要将 Spire.PDF for .NET 包中包含的 DLL 文件添加为 .NET 项目中的引用。可以从此链接下载 DLL 文件，也可以通过 NuGet 安装 DLL 文件。
PM> Install-Package Spire.PDF下载插件
如果你选择使用插件来转换，请从以下链接下载适合你操作系统的插件。
解压下载的压缩包到磁盘中，即可看到 “plugin” 文件夹，在该演示中，我们将其放在 “F:\Libraries\Plugin\plugins-windows-x64\plugins” 文件夹下。
同时，也建议将项目的“目标平台”设置为对应的 x86 或 x64。
使用 QT 插件将 URL 转换为 PDF
以下是使用 Spire.PDF for .NET 与 QT 插件将 URL 转换为 PDF 的详细操作步骤。
- 指定要转换的 URL 地址。
- 指定生成 PDF 文件的路径。
- 指定插件的路径，并将其指定为 HtmlConverter.PluginPath 属性的值。
- 调用 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.wikipedia.org/";
//指定输出文件路径
string fileName = "Url转Pdf.pdf";
//指定插件路径
string pluginPath = "F:\\Libraries\\Plugin\\plugins-windows-x64\\plugins";
//设置插件路径
HtmlConverter.PluginPath = pluginPath;
//将URL转换为PDF
HtmlConverter.Convert(url, fileName, true, 100000, new Size(1080, 1000), new PdfMargins(0));
}
}
}使用 QT 插件将 HTML 字符串转换为 PDF
以下是使用 Spire.PDF 与 QT 插件将 HTML 字符串转换为 PDF 的详细操作步骤。
- 从 .html 文件中获取 HTML 字符串。
- 指定生成的 PDF 文件的路径。
- 指定插件的路径，并将其作为 HtmlConverter.PluginPath 属性的值。
- 调用 HtmlConverter.Convert(string htmlString, string fileName, bool enableJavaScript, int timeout, SizeF pageSize, PdfMargins margins, Spire.Pdf.HtmlConverter.LoadHtmlType htmlType) 方法将 HTML 字符串转换为 PDF 文档。
注意：只有内联 CSS 样式和内部 CSS 样式可以在 PDF 上正确呈现。如果你有一个外部 CSS 样式表，请将其转换为内联或内部 CSS 样式。
- 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(@"C:\示例.html");
//指定输出文件路径
string fileName = "Html字符串转Pdf.pdf";
//指定插件路径
string pluginPath = "F:\\Libraries\\Plugin\\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);
}
}
}不使用插件将 URL 转换为 PDF
以下是使用 Spire.PDF for .NET 在没有插件的情况下转换 URL 为 PDF 的详细操作步骤。
- 创建 PdfDocument 类的对象。
- 创建 PdfPageSettings 类的对象，并用其设置页面大小和页边距。
- 创建 PdfHtmlLayoutFormat 类的对象，并将其 IsWaiting 属性设置为 true。
- 指定要转换的 URL 地址。
- 使用 PdfDocument.LoadFromHTML() 方法从 URL 地址加载 HTML。
- 使用 PdfDocument.SaveToFile() 方法保存为 PDF 文档。
- C#
using Spire.Pdf;
using System;
using System.Drawing;
using Spire.Additions.Html;
using System.Threading;
namespace ConverUrlToPdfWithoutPlugin
{
class Program
{
static void Main(string[] args)
{
//创建 PdfDocument 类的对象
PdfDocument doc = new PdfDocument();
//创建 PdfPageSettings 类的对象
PdfPageSettings setting = new PdfPageSettings();
//通过该对象保存页面大小和页边距
setting.Size = new SizeF(1000, 1000);
setting.Margins = new Spire.Pdf.Graphics.PdfMargins(20);
//创建 PdfHtmlLayoutFormat 类的对象
PdfHtmlLayoutFormat htmlLayoutFormat = new PdfHtmlLayoutFormat();
//将 IsWaiting 属性设置为true
htmlLayoutFormat.IsWaiting = true;
//指定要转换的URL地址
String url = "https://www.wikipedia.org/";
//从URL地址加载HTML
Thread thread = new Thread(() =>
{ doc.LoadFromHTML(url, true, true, false, setting, htmlLayoutFormat); });
thread.SetApartmentState(ApartmentState.STA);
thread.Start();
thread.Join();
//将文档保存为PDF文件
doc.SaveToFile("Url转Pdf.pdf");
doc.Close();
}
}
}不使用插件将 HTML 字符串转换为 PDF
以下是使用 Spire.PDF for .NET 在没有插件的情况下转换 HTML 字符串为 PDF 文档的步骤。
- 创建 PdfDocument 类的对象。
- 创建 PdfPageSettings 类的对象，并通过它设置页面大小和页边距。
- 创建 PdfHtmlLayoutFormat 类的对象，并把其 IsWaiting 属性设置为 true。
- 从 .html文件中读取 HTML 字符串。
- 使用 PdfDocument.LoadFromHTML() 方法从 HTML 字符串中加载 HTML。
- 使用 PdfDocument.SaveToFile() 方法将文档保存为一个 PDF 文件。
- C#
using Spire.Pdf;
using System.Drawing;
using Spire.Additions.Html;
using System.Threading;
using System.IO;
namespace ConvertHtmlStringToPdfWithoutPlugin
{
class Program
{
static void Main(string[] args)
{
//创建 PdfDocument 类的对象
PdfDocument doc = new PdfDocument();
//创建 PdfPageSettings 类的对象
PdfPageSettings setting = new PdfPageSettings();
//通过该对象保存页面大小和页边距
setting.Size = new SizeF(1000, 1000);
setting.Margins = new Spire.Pdf.Graphics.PdfMargins(20);
//创建 PdfHtmlLayoutFormat 类的对象
PdfHtmlLayoutFormat htmlLayoutFormat = new PdfHtmlLayoutFormat();
//将 IsWaiting 属性设置为true
htmlLayoutFormat.IsWaiting = true;
//从.html文件中读取html字符串
string htmlString = File.ReadAllText(@"C:\示例.html");
//从html字符串中加载HTML
Thread thread = new Thread(() =>
{ doc.LoadFromHTML(htmlString, true, setting, htmlLayoutFormat); });
thread.SetApartmentState(ApartmentState.STA);
thread.Start();
thread.Join();
//保存为PDF文件
doc.SaveToFile("Html字符串转Pdf.pdf");
}
}
}申请临时 License
如果您希望删除结果文档中的评估消息，或者摆脱功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。
