,,

HtmlToPDFCore：HTML 轉(zhuǎn)換為 PDF 的利器,輕便,快捷,重量級(jí)

當(dāng)前位置：點(diǎn)晴教程→知識(shí)管理交流 →『技術(shù)文檔交流』

2025年3月24日 12:19 本文熱度 383

在日常開(kāi)發(fā)中，我們常常需要將動(dòng)態(tài)生成的 HTML 內(nèi)容轉(zhuǎn)換為 PDF 文件。無(wú)論是用于打印、存檔還是分享，PDF 格式都因其跨平臺(tái)兼容性和穩(wěn)定性而備受青睞。今天，我們就來(lái)介紹一個(gè)強(qiáng)大的工具——HtmlToPDFCore，可以輕松實(shí)現(xiàn) HTML 到 PDF 的轉(zhuǎn)換，這真是輕便快捷重量級(jí)。

一、HtmlToPDFCore 是什么？

HtmlToPDFCore 是一個(gè)基于 .NET Core 的開(kāi)源庫(kù)，能夠?qū)?HTML 文件或字符串轉(zhuǎn)換為高質(zhì)量的 PDF 文件。內(nèi)置了適用于 Windows、Linux 和 macOS 的 Rotativa 文件，因此可以無(wú)縫運(yùn)行在多種環(huán)境中。

主要特點(diǎn)：

? 支持多平臺(tái)（Windows、Linux、macOS）。
? 高質(zhì)量的 PDF 輸出。
? 易于集成到 .NET Core 項(xiàng)目中。
? 提供豐富的配置選項(xiàng)（如頁(yè)面大小、方向、邊距等）。
? 無(wú)需依賴(lài)項(xiàng)（wkhtmltopdf）

二、適用場(chǎng)景

HtmlToPDFCore 可以廣泛應(yīng)用于以下場(chǎng)景：

1. 生成報(bào)表：將動(dòng)態(tài)生成的 HTML 報(bào)表轉(zhuǎn)換為 PDF。
2. 合同和協(xié)議：將在線編輯的合同內(nèi)容保存為 PDF。
3. 發(fā)票和收據(jù)：將交易記錄導(dǎo)出為 PDF 文件。
4. 文檔歸檔：將網(wǎng)頁(yè)內(nèi)容保存為 PDF 以便長(zhǎng)期存儲(chǔ)。

三、環(huán)境支持

HtmlToPDFCore 已經(jīng)過(guò)測(cè)試，支持以下運(yùn)行環(huán)境：

? Windows
? Linux
? Microsoft Azure 應(yīng)用服務(wù)（使用 Linux 服務(wù)計(jì)劃）
? Docker 容器

四、安裝方法

在 Visual Studio 中，可以通過(guò) NuGet 包管理器控制臺(tái)安裝 HtmlToPDFCore。執(zhí)行以下命令即可完成安裝：

Install-Package HtmlToPDFCore

如果你使用的是 .NET CLI，也可以通過(guò)以下命令安裝：

dotnet add package HtmlToPDFCore

五、快速上手

展示如何使用 HtmlToPDFCore 將 HTML 字符串轉(zhuǎn)換為 PDF 文件

using System;
using System.IO;
using Wkhtmltopdf.NetCore;

classProgram
{
    static void Main(string[] args)
    {
        // 定義 HTML 內(nèi)容
        var html = @"
            <html>
                <title>PDF 示例</title>
                <body>
                    <b>PDF 示例 - Carlos dos Santos</b>
                    <b> 公眾號(hào)：Net分享 </b>
                    <b> https://mp.weixin.qq.com/s/LWuzVwJ6J9UyqnmP_1ecPw</b>
                    <b>NetShre ：https://www.dotnetshare.com</b>
                </body>
            </html>";

        // 初始化 HtmlToPDF 對(duì)象
        var pdf = new HtmlToPDF();

        // （可選）設(shè)置 PDF 參數(shù)
        // pdf.DisableSmartShrinking = true;
        // pdf.Margins = new PageMargins(5, 5, 5, 5);
        // pdf.Orientation = PageOrientation.Landscape;
        // pdf.PageSize = Wkhtmltopdf.NetCore.Options.Size.A4;

        // 將 HTML 轉(zhuǎn)換為 PDF 字節(jié)流
        var buffer = pdf.ReturnPDF(html);

        // 定義輸出文件路徑
        string pdfFile = "output.pdf";

        // 如果文件已存在，則刪除
        if (File.Exists(pdfFile)) File.Delete(pdfFile);

        // 將字節(jié)流寫(xiě)入文件
        using (var f = new FileStream(pdfFile, FileMode.Create))
        {
            f.Write(buffer, 0, buffer.Length);
            f.Flush();
        }

        Console.WriteLine("PDF 文件已成功生成！");
    }
}

六、高級(jí)配置

HtmlToPDFCore 提供了許多高級(jí)配置選項(xiàng)，可以幫助你更精細(xì)地控制生成的 PDF 文件。以下是一些常用的配置參數(shù)：

參數(shù)名	描述
`DisableSmartShrinking`	禁用智能縮放功能
`Margins`	設(shè)置頁(yè)面邊距（單位：毫米）
`Orientation`	頁(yè)面方向（縱向/橫向）
`PageSize`	頁(yè)面大小（如 A4、Letter 等）

七、項(xiàng)目地址

https://github.com/carloscds/HtmlToPDFCore?

八、總結(jié)

HtmlToPDFCore 是一個(gè)功能強(qiáng)大且易于使用的工具，可以幫助開(kāi)發(fā)者快速實(shí)現(xiàn) HTML 到 PDF 的轉(zhuǎn)換。無(wú)論你是需要生成報(bào)表、合同還是其他類(lèi)型的文檔，它都能滿(mǎn)足你的需求。
需要注意的是在liunx環(huán)境或者是docker需要安裝對(duì)應(yīng)的字體，趕快動(dòng)手試試吧！

該文章在 2025/3/24 17:29:11 編輯過(guò)

關(guān)鍵字查詢(xún)

HTML

快捷

轉(zhuǎn)換

重量

相關(guān)文章

正在查詢(xún)...