C#怎么生成PDF报表_C# DinkToPdf基于HTML导出PDF【实用】-C#.Net教程-PHP中文网

dinktopdf 在 .net 6+ 上默认无法运行，因其依赖本地 wkhtmltopdf 二进制文件，而单文件发布或裁剪会致 system.dllnotfoundexception；需禁用裁剪、显式指定路径、安装系统依赖并单例初始化 converter。

c#怎么生成pdf报表_c# dinktopdf基于html导出pdf【实用】

为什么 DinkToPdf 在 .NET 6+ 上默认跑不起来

DinkToPdf 本质是封装了 wkhtmltopdf 的 C# 绑定库，它依赖本地 wkhtmltopdf 二进制文件（Linux/macOS 是可执行文件，Windows 是 DLL）。.NET Core/.NET 6+ 默认启用“单文件发布”或“裁剪托管代码”，会导致运行时找不到原生依赖，直接抛出 System.DllNotFoundException: Unable to load DLL 'wkhtmltopdf'。

常见错误现象包括：本地调试正常，发布后报错；或在 Linux 容器里提示 libgdiplus 缺失（尤其 CentOS/Alpine）。

必须显式指定 wkhtmltopdf 二进制路径，不能依赖自动查找
Linux 下需提前安装系统依赖：libgdiplus、fontconfig、libx11（Ubuntu/Debian 用 apt install libgdiplus fontconfig libx11-6）
Alpine 镜像要换用 wkhtmltopdf-static 或改用 mcr.microsoft.com/dotnet/aspnet:6.0-jammy 等带完整图形栈的基础镜像
.NET 6+ 项目需在 .csproj 中禁用裁剪：<publishtrimmed>false</publishtrimmed>

怎么正确初始化 IDinkToPdfConverter 并避免线程安全问题

IDinkToPdfConverter 不是线程安全的，但创建实例开销大（加载 native 库、初始化上下文），不能每次导出都 new 一个。官方示例里用 new BasicConverter(new PdfTools()) 是反模式，会导致内存泄漏和并发异常。

正确做法是全局单例 + 手动管理生命周期：

使用HTML,CSS,JavaScript开发Android应用程序英文文字pdf版附源文件

如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更

下载

在 Program.cs 中注册为单例：

var converter = new BasicConverter(new PdfTools());<br>builder.Services.AddSingleton<idinktopdfconverter>(sp => converter);</idinktopdfconverter>

确保 PdfTools 构造时传入真实路径，例如：new PdfTools { ExecutablePath = "/usr/local/bin/wkhtmltopdf" }（Linux）或 "C:\wkhtmltopdf\wkhtmltopdf.exe"（Windows）
不要在 using 块中使用 converter——它不是 IDisposable，强行 dispose 可能导致后续调用崩溃
若部署多实例（如 K8s 多 Pod），每个进程仍需独立加载自己的 wkhtmltopdf，不存在跨进程共享问题

HTML 模板里哪些 CSS 会失效或渲染异常

wkhtmltopdf 使用 Qt WebKit 渲染引擎（老版本）或 Blink（新版本），对现代 CSS 支持有限。不是所有浏览器能显示的样式，PDF 都能还原。

flex 布局基本不可靠，建议改用 table 或 float + 固定宽高
@media print 规则会被忽略，必须用 @page 控制页边距：@page { margin: 2cm; }
中文字体必须显式声明且确保系统已安装，否则显示方块。推荐用 @font-face 内联 WOFF 字体或指定系统字体名如 "Microsoft YaHei", "SimSun", sans-serif
背景图、渐变、transform、filter 大概率不渲染，不要依赖
页面分页控制优先用 page-break-inside: avoid 和 page-break-after: always，而非 JS 插件

怎么让导出 PDF 支持中文、页眉页脚、目录和密码保护

DinkToPdf 本身只提供基础转换接口，页眉页脚、目录、加密等能力要靠 wkhtmltopdf 命令行参数透传实现，对应到 C# 就是填充 GlobalSettings 和 ObjectSettings。

中文支持关键在 GlobalSettings 设置：LoadImages = true、PrintBackground = true、Orientation = Orientation.Portrait，并确保 HTML 中 <meta charset="utf-8">
页眉页脚用 HeaderSettings/FooterSettings，支持 HTML 片段，变量如 [page]、[toPage]、[date] 会自动替换
生成目录需要 HTML 中有 <h1></h1>~<h6></h6> 标签，并在 ObjectSettings 中设 Outline = true，再配合 OutlineSettings 控制层级
密码保护只能通过 GlobalSettings 的 EnableJavaScript = true + 后续用外部工具（如 iTextSharp）二次加水印/加密，DinkToPdf 本身不支持 PDF 加密