Mikel
来源： DinkToPdf: .Net轻松搞定Html转PDF生成，几分钟上手！
大家好，我是深山踏红叶，今天来分享一个HTML 转 PDF 的相关库，DinkToPdf 是一个基于 .NET Core 的封装库，用于调用 wkhtmltopdf 库，通过 WebKit 渲染引擎将 HTML 页面转换为 PDF 文件。
核心功能
-
• HTML 到 PDF 的转换：支持将 HTML 内容转换为 PDF 文件，同时提供多种页面设置和布局选项。 -
• 多线程支持：提供了同步转换器，适用于多线程应用程序和 Web 服务器。 -
• 丰富的配置选项：可以设置纸张大小、方向、边距、颜色模式等，还可以自定义页眉和页脚。
使用方法
1. 安装依赖
通过 NuGet 包管理器添加 DinkToPdf 依赖。
PM> Install-Package DinkToPdf将本机库复制到项目的根文件夹。使用 P/Invoke 调用本机方法时，.NET Core 会从那里加载本机库。您可以在此处找到最新版本的本机库。为您的操作系统和平台（64 位或 32 位）选择合适的库。
2. 创建转换器实例
根据应用场景选择 BasicConverter 或 SynchronizedConverter。
var converter = new SynchronizedConverter(new PdfTools());3. 构造 HTML 内容
可以是直接的 HTML 字符串，也可以是通过 URL 获取的页面内容。
var doc = new HtmlToPdfDocument()
{
GlobalSettings = {
ColorMode = ColorMode.Color,
Orientation = Orientation.Portrait,
PaperSize = PaperKind.A4,
Margins = new MarginSettings() { Top = 10 },
Out = @"C:TestThreadSafe\test.pdf",
},
Objects = {
new ObjectSettings()
{
Page = "https://www.dotnetshare.com/",
},
}
};4. 配置转换文档
通过 HtmlToPdfDocument 设置全局参数和对象参数。
var doc = new HtmlToPdfDocument()
{
GlobalSettings = {
ColorMode = ColorMode.Color,
Orientation = Orientation.Landscape,
PaperSize = PaperKind.A4Plus,
},
Objects = {
new ObjectSettings() {
PagesCount = true,
HtmlContent = @"Lorem ipsum dolor sit amet, consectetur adipiscing elit. In consectetur mauris eget ultrices iaculis. Ut odio viverra, molestie lectus nec, venenatis turpis.",
WebSettings = { DefaultEncoding = "utf-8" },
HeaderSettings = { FontSize = 9, Right = "Page [page] of [toPage]", Line = true, Spacing = 2.812 }
}
}
};5. 执行转换
调用 converter.Convert(doc) 方法完成转换。
byte[] pdf = converter.Convert(doc);
File.WriteAllBytes("example7.pdf", pdf);6. 依赖关系注入
转换器必须注册为单例。
public void ConfigureServices(IServiceCollection services)
{
// Add converter to DI
services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));
}完整实例
using DinkToPdf;
using DinkToPdf.Contracts;
using System;
namespaceDinkToPdfExample
{
publicclassProgram
{
public static void Main(string[] args)
{
var converter = new BasicConverter(new PdfTools());
//需要下载wkhtmltopdf工具 https://gitcode.com/gh_mirrors/di/DinkToPdf/blob/master/v0.12.4/64%20bit/
var doc = new HtmlToPdfDocument()
{
GlobalSettings = {
ColorMode = ColorMode.Color,
Orientation = Orientation.Portrait,
PaperSize = PaperKind.A4,
},
Objects = {
new ObjectSettings() {
//PagesCount = true,
HtmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
<meta charset=""UTF-8"">
<meta name=""viewport"" content=""width=device-width, initial-scale=1.0"">
<title>Title</title>
<style>
table {
width: 50%;
border-collapse: collapse;
margin: 20px auto;
}
th, td {
border: 1px solid #000;
padding: 8px;
text-align: center;
}
th {
background-color: #f2f2f2;
}
</style>
</head>
<body>
<h2 style=""text-align: center;"">Netshare</h2>
<table>
<thead>
<tr>
<th>姓名</th>
<th>年龄</th>
<th>职业</th>
</tr>
</thead>
<tbody>
<tr>
<td>张三</td>
<td>25</td>
<td>程序员</td>
</tr>
<tr>
<td>李四</td>
<td>30</td>
<td>设计师</td>
</tr>
<tr>
<td>王五</td>
<td>28</td>
<td>产品经理</td>
</tr>
</tbody>
</table>
</body>
</html>
",
WebSettings = { DefaultEncoding = "utf-8" },
//HeaderSettings = { FontSize = 9, Right = "Page [page] of [toPage]", Line = true, Spacing = 2.812 }
}
}
};
byte[] pdf = converter.Convert(doc);
File.WriteAllBytes("example8.pdf", pdf);
}
}
}注意事项
-
• DinkToPdf 依赖于 wkhtmltopdf，部署时需确保相关 DLL 文件存在。 -
• 在某些情况下，可能需要额外配置字体路径以支持中文等特殊字符。
问题解决方案
One or more errors occurred. (Unable to load shared library ‘libwkhtmltox’ or one of its dependencies)
将项目下的 libwkhtmltox.dll 文件复制到项目目录下即可解决该问题。并且需要在根目录中包含 libwkhtmltox.dll、libwkhtmltox.dylib 和 libwkhtmltox.so，并在 .csproj 文件中包含以下内容：
文件地址：https://github.com/rdvojmoc/DinkToPdf/tree/master/v0.12.4
<ItemGroup>
<None Update="libwkhtmltox.dll">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
<None Update="libwkhtmltox.dylib">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
<None Update="libwkhtmltox.so">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
</ItemGroup>项目地址
https://github.com/rdvojmoc/DinkToPdf
