HtmlToPdfDocument C# - DinkToPdf 替代軟體 | IronPDF

DinkToPdf PDF 輸出。

常見問題包括：即使是簡單的任務，PDF 生成速度也過慢；網頁伺服器上的多執行緒處理複雜；以及難以處理含有 JavaScript 的網頁內容。 wkhtmltopdf 命令列工具為 Azure App Service 及無伺服器環境帶來部署上的挑戰，因為在這些環境中無法安裝系統層級的二進位檔。 開發人員亦指出，在並發負載下，單例轉換器模式會成為效能瓶頸。

除了效能問題外，GitHub 上的 DinkToPdf 專案顯示維護活動有限，這意味著 CSS 渲染或 SSL 處理方面的錯誤很少獲得修正。 對於每日處理數千份 PDF 的生產環境應用程式而言，這些缺口是無法接受的。 當 CSS Grid 佈局出現錯誤或網頁字型無法載入時，您需要的是能追蹤現代瀏覽器行為的函式庫，而非仍停留在 2010 年代初期渲染引擎時代的過時方案。

IronPDF HTML 字串輸出

。

此程式碼示範了 IronPDF 在轉換過程中如何處理 HTML 和 CSS，產出具有正確字型大小渲染與文字對齊的 PDF 文件——且完全不依賴外部套件。 RenderHtmlAsPdf 方法接受任何有效的 HTML5 字串，包括內嵌樣式、嵌入式腳本以及用於圖片的資料 URI。

如何將 HTML 檔案轉換為 PDF？

若要轉換儲存於磁碟上的 HTML 檔案：

using IronPdf;

var renderer = new ChromePdfRenderer();
var doc = renderer.RenderHtmlFileAsPdf("templates/input.html");
doc.SaveAs("example.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
var doc = renderer.RenderHtmlFileAsPdf("templates/input.html");
doc.SaveAs("example.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim doc = renderer.RenderHtmlFileAsPdf("templates/input.html")
doc.SaveAs("example.pdf")

。

RenderHtmlFileAsPdf 方法會將圖片、樣式表和腳本的相對路徑，轉換為以 HTML 檔案在磁碟上的位置為基準的絕對路徑，因此現有範本無需修改即可正常運作。 這使得遷移現有的報表範本變得相當簡單。

如何將網頁 URL 轉換為 PDF？

在轉換即時網頁內容方面，IronPDF 遠勝於 DinkToPdf 有限的 JavaScript 渲染能力。 IronPDF 的 Chromium 引擎支援動態 HTML 元素、單頁應用程式及互動式表單。

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

string url = "https://en.wikipedia.org/wiki/Main_Page";
var page = renderer.RenderUrlAsPdf(url);
page.SaveAs("webpage.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

string url = "https://en.wikipedia.org/wiki/Main_Page";
var page = renderer.RenderUrlAsPdf(url);
page.SaveAs("webpage.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

' Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(500)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

Dim url As String = "https://en.wikipedia.org/wiki/Main_Page"
Dim page = renderer.RenderUrlAsPdf(url)
page.SaveAs("webpage.pdf")

將 URL 轉換為 PDF

此方法非常適合用於從網頁表單生成發票，或將即時儀表板進行歸檔。 渲染引擎會在產生 PDF 檔案前，先處理所有網頁字型、CSS 樣式及 JavaScript。WaitFor API 讓您能精確控制 Chromium 引擎何時判定頁面已準備好進行擷取——您可以等待特定的 DOM 元素、網路閒置狀態，或自訂的 JavaScript 條件，這對於從動態內容生成大規模 PDF 至關重要。

對於需要驗證的頁面，您可以直接將 HTTP 標頭、Cookie 或表單 POST 資料傳遞給渲染器。 PDF 文件中的連結詳細說明了這些進階情境。

如何設定 PDF 輸出設定？

兩個庫都提供了配置選項，但 IronPDF 透過其 RenderingOptions 物件提供了對生成的 PDF 更直觀的控制：

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.TextHeader.CenterText = "Company Report";
renderer.RenderingOptions.TextFooter.CenterText = "{page} of {total-pages}";

var document = renderer.RenderHtmlAsPdf("<h1 style='text-align: center;'>Quarterly Report</h1>");
document.SaveAs("configured-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.TextHeader.CenterText = "Company Report";
renderer.RenderingOptions.TextFooter.CenterText = "{page} of {total-pages}";

var document = renderer.RenderHtmlAsPdf("<h1 style='text-align: center;'>Quarterly Report</h1>");
document.SaveAs("configured-report.pdf");

Imports IronPdf

Dim renderer = New ChromePdfRenderer()

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.TextHeader.CenterText = "Company Report"
renderer.RenderingOptions.TextFooter.CenterText = "{page} of {total-pages}"

Dim document = renderer.RenderHtmlAsPdf("<h1 style='text-align: center;'>Quarterly Report</h1>")
document.SaveAs("configured-report.pdf")

輸出帶有自訂設定的 PDF

這些選項用於控制紙張尺寸、邊距、頁首及頁尾。 IronPDF 亦支援可接受完整 HTML 與 CSS 的自訂 HTML 頁首與頁尾，讓您能在頁首與頁尾區域放置標誌、動態頁數計數器及樣式化文字。 為確保文件安全性，PDF 加密與密碼 API 可讓您在生成文件後限制其列印、複製或編輯功能。

如何合併多個 PDF 檔案？

當您需要將多個 HTML 文件合併為一個 PDF 時，IronPDF 提供了一種靜態合併方法：

using IronPdf;

var renderer = new ChromePdfRenderer();

var pdf1 = renderer.RenderHtmlAsPdf("<h1>Section One</h1>");
var pdf2 = renderer.RenderHtmlAsPdf("<h1>Section Two</h1>");

var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged-report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

var pdf1 = renderer.RenderHtmlAsPdf("<h1>Section One</h1>");
var pdf2 = renderer.RenderHtmlAsPdf("<h1>Section Two</h1>");

var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged-report.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim pdf1 = renderer.RenderHtmlAsPdf("<h1>Section One</h1>")
Dim pdf2 = renderer.RenderHtmlAsPdf("<h1>Section Two</h1>")

Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged-report.pdf")

PDF 合併文件說明了如何從多個來源檔案組合大型文件、在所有章節中套用一致的頁首與頁尾，以及透過程式碼重新排列頁面順序。 這對於報告生成流程特別有用，該流程會先獨立建構各個章節，再將其組合成一份最終文件。

您為何要從 DinkToPdf 轉換到 IronPDF？

對於在 .NET Core 應用程式中使用 HtmlToPdfDocument 的開發人員來說，IronPDF 提供了直接解決每個痛點的關鍵優勢：

• 現代渲染：Chromium 引擎負責處理 HTML 結構、現代 CSS 以及 JavaScript 執行，以生成像素級精準的 PDF 文件
• 零設定：無需 wkhtmltopdf 二進位檔或命令列工具設定——只需新增 NuGet 套件
• 更佳效能：擺脫單執行緒限制，實現更快速的 PDF 轉換； 渲染器是線程安全的，可以並發執行轉換。
• 完整網頁支援：可轉換包含網頁字型、CSS 動畫、SVG 圖形及複雜 HTML 範本的 HTML 內容
• Enterprise 部署：無需額外配置即可部署至 Azure App Service、AWS Lambda、Docker 容器及傳統網頁伺服器
• 進階 PDF 功能：可填寫的 PDF 表單、數位簽章、符合 PDF/A 標準，以及浮水印
• 積極維護：IronPDF 會定期發布更新，以追蹤最新的 Chromium 版本和 .NET 執行環境

根據 Chromium 專案的發布時程表，該引擎每四週會收到一次安全性修補程式。 IronPDF 會在每次主要版本發布時捆綁最新的 Chromium 版本，確保您的 PDF 生成功能始終保持最新，無需手動管理二進位檔。 這對重視安全的團隊至關重要，這些團隊需要證明其依賴項已針對已知漏洞進行修補。

IronPDF 文件庫涵蓋超過 50 篇操作指南，內容涵蓋從分割 PDF 到擷取文字及新增註解等各項任務。