如何在 C# 中將 HTML 字串轉換為 PDF

IronPdf 使用 Chrome 渲染引擎以 C# 將 HTML 字串轉換為 PDF 文件，支援所有 HTML5、CSS3 和 JavaScript 內容，只需一行程式碼即可完成基本轉換。 該函式庫為 創建 PDF 提供了強大的功能，同時保持完美的渲染保真度。

IronPDF 讓開發人員可以輕鬆使用 C#、F# 和 VB.NET 為 .NET Core 和 .NET Framework 建立 PDF 文件。 IronPdf 支援將任何 HTML 字串渲染為 PDF，渲染過程使用功能完整的 Google Chromium 引擎版本。這可確保 HTML 內容在現代網頁瀏覽器中的顯示效果完全一樣，因此非常適合從動態 HTML 內容生成報表、發票和文件。

<！--說明：說明程式碼概念的圖表或截圖 -->

快速入門：幾秒鐘內將 HTML 字串轉換為 PDF

使用 IronPDF 將 HTML 字串轉換成 PDF 檔案。 本指南示範如何在 C# 中以最少的程式碼將 HTML 字串轉換為 PDF 文件。 非常適合需要將 PDF 渲染功能整合到專案中的開發人員。

最小工作流程（5 個步驟）

1. 從 NuGet 下載 IronPDF C# 庫
2. 實例化 PDF 渲染器並傳遞 HTML 字串
3. 配置 PDF 中外部資源的 BasePath
4. 配置渲染選項以微調輸出 PDF
5. 儲存並下載生成的 PDF

如何將簡單的 HTML 字串轉換為 PDF？ 以下是 IronPDF 使用 `RenderHtmlAsPdf` 方法將 HTML 字串渲染為 PDF 的範例。 該參數是一個HTML字串，將被渲染成PDF檔案。 此方法是 `ChromePdfRenderer` 類的一部分，它提供廣泛的 [ 渲染選項控制](https://ironpdf.com/how-to/rendering-options/)，滿足您的 PDF 生成需求。 --> <！--說明：說明程式碼概念的圖表或截圖 --> ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf.cs ``` `RenderHtmlAsPdf`方法傳回一個`PdfDocument`對象，該類別用於保存 PDF 資訊。 此物件提供許多操作 PDF 的方法，包括 [合併 PDF](https://ironpdf.com/how-to/merge-or-split-pdfs/)、[加入水印](https://ironpdf.com/how-to/custom-watermark/)，以及 [設定安全選項](https://ironpdf.com/how-to/pdf-permissions-passwords/)。 當 HTML 字串從外部來源取得，且您需要停用本機磁碟存取或跨來源請求時，請將 `ChromePdfRenderer.EnableWebSecurity` 屬性設定為 true。 對於包含 CSS 樣式的複雜 HTML 內容，請使用內嵌樣式增強您的 HTML 字串，或使用 [Base URLs & Asset Encoding](https://ironpdf.com/how-to/base-urls/) 功能參考外部樣式表： ```csharp // Example with inline CSS var styledHtml = @"

This PDF was generated from HTML with custom styling.

"; var styledPdf = renderer.RenderHtmlAsPdf(styledHtml); styledPdf.SaveAs("styled-output.pdf"); ```

生成的 PDF 是什麼樣子？ 這是程式碼產生的檔案： 生成的 PDF 會完全保留 HTML 的格式和樣式，因此非常適合 [ 生成 PDF 報告](https://ironpdf.com/how-to/csharp-pdf-reports/)，或將網頁內容轉換為可直接列印的文件。

將 HTML 轉換為 PDF 時，我該如何包含外部資產？ 此範例顯示 IronPDF 從可選的 BasePath 載入外部影像資產。 設定 BaseUrlOrPath 屬性可以為超連結、映像、CSS 和 JavaScript 檔案提供相對檔案路徑或 URL 上下文。 在使用 [ PDF 中的圖片](https://ironpdf.com/how-to/add-images-to-pdfs/)或需要參考外部資源時，此功能是不可或缺的。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs ``` 對於涉及複雜佈局或動態內容的進階方案，請利用 IronPDF 對 [JavaScript 渲染](https://ironpdf.com/how-to/javascript-to-pdf/)的支援： ```csharp // Example with JavaScript-generated content var jsHtml = @"

"; // Configure rendering to wait for JavaScript execution renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\"); dynamicPdf.SaveAs("dynamic-content.pdf"); ``` 在處理外部資產時，可能需要處理驗證或特殊標頭。 IronPDF 透過 [HTTP Request Header](https://ironpdf.com/how-to/http-request-header/) 功能提供支援，讓您在取得資源時包含授權標記或自訂標頭。

為什麼設定 BasePath 對外部資源很重要？ 這是程式碼產生的檔案： 正確設定 BasePath 可確保能正確解析 HTML 中的所有相對引用。 沒有它，IronPDF 無法定位圖片、樣式表或腳本等外部資源。這在以下情況尤其重要： 1.轉換引用本機檔案系統資源的 HTML 2.使用相對 URL 的內容管理系統工作 3.將現有的網頁內容轉換為 PDF 格式 4.建立使用共用資產的範本 對於網頁型資源，請使用完整的 URL 作為基本路徑： ```csharp // Using a web URL as base path var webBasedPdf = renderer.RenderHtmlAsPdf( "", "https://mywebsite.com" ); ``` 如需對 PDF 生成過程進行更多控制，請探索 IronPDF 有關 [自訂頁邊空白](https://ironpdf.com/how-to/custom-margins/)、[頁面方向](https://ironpdf.com/how-to/page-orientation-rotation/) 和 [PDF壓縮](https://ironpdf.com/how-to/pdf-compression/) 的廣泛說明文件，以便針對各種使用情況優化您的輸出檔案。