1. IronPDF
  2. 操作指南
  3. 如何將 HTML 字串渲染成 PDF
如何在 C# 中將 HTML 字串渲染為 PDF | IronPDF

How to Convert HTML String to PDF in C#

Regan Pun
Regan Pun
更新日期:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 允許開發人員在 C#、F# 和 VB.NET 中輕鬆建立 PDF 文件，適用於 .NET Core 和 .NET Framework。 IronPDF 支援將任何 HTML 字串轉換為 PDF，並且渲染過程由完全功能的 Google Chromium 引擎完成。

快速入門：在數秒內將 HTML 字串轉換為 PDF

使用 IronPDF 輕鬆將 HTML 字串轉換為 PDF 文件。 本指南演示如何僅用幾行代碼快速將 HTML 字串轉換為 C# 中的 PDF 文件。 非常適合希望將高效 PDF 渲染功能整合到其專案中的開發人員。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小工作流程（5 步驟）

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


HTML 字串到 PDF 示例

這裡我們有一個示例，IronPDF 使用 RenderHtmlAsPdf 方法將 HTML 字串渲染為 PDF。 參數是一個要渲染為 PDF 的 HTML 字串。

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

RenderHtmlAsPdf 方法返回一個 PdfDocument 對象，這是一個用於保存 PDF 信息的類。

在從外部來源獲取 HTML 字串且希望禁用本地磁碟存取或跨域請求的情況下，可以將 ChromePdfRenderer.EnableWebSecurity 屬性設置為 true 來實現。

結果

這是代碼生成的文件：

高級 HTML 到 PDF 示例

這裡我們有一個示例，IronPDF 從可選的 BasePath 讀取了外部圖像資產。 設置 BaseUrlOrPath 屬性可為超連結、圖片、CSS 和 JavaScript 文件提供相對文件路徑或 URL 環境。

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Advanced Example with HTML Assets
' Load external html assets: Images, CSS and JavaScript.
' An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
Private myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")
myAdvancedPdf.SaveAs("html-with-assets.pdf")
$vbLabelText   $csharpLabel

這是代碼生成的文件：

常見問題解答

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

若要在 C# 中將 HTML 字串轉換為 PDF，可以使用 IronPDF 的 ` IronPdf.ChromePdfRender類別中的 ` StaticRenderHtmlAsPdf方法。此方法接受一個 HTML 字串作為輸入，將其渲染為 PDF，並允許您將其儲存為檔案。

將 HTML 字串渲染成 PDF 需要哪些步驟？

使用 IronPDF 將 HTML 字串渲染為 PDF 的步驟包括：從 NuGet 下載 IronPDF 庫，實例化 PDF 渲染器，傳遞 HTML 字串，配置渲染選項（例如外部資源的 BasePath），以及保存產生的 PDF。

我可以在PDF檔案中插入外部圖片和CSS代碼嗎？

是的，IronPDF 允許您透過設定BaseUrlOrPath屬性在 PDF 中包含外部圖像和 CSS。此屬性為在將 HTML 渲染為 PDF 時載入圖像、CSS 和 JavaScript 檔案等資源提供上下文。

如何提高從外部來源渲染 HTML 時的安全性？

為了增強從外部來源渲染 HTML 時的安全性，您可以在 IronPDF 中將ChromePdfRenderer.EnableWebSecurity屬性設定為 true。這將禁用本機磁碟存取和跨網域請求。

在 IronPDF 中設定 BaseUrlOrPath 屬性的目的是什麼？

IronPDF 中的BaseUrlOrPath屬性用於定義載入外部資源（例如圖像、CSS 和 JavaScript 檔案）的基本路徑或 URL 上下文。它確保在將 HTML 渲染為 PDF 時正確引用這些資源。

在 IronPDF 中，儲存渲染後的 PDF 檔案使用什麼方法？

使用 IronPDF 將 HTML 字串渲染成 PDF 後，您可以透過呼叫PdfDocument物件的SaveAs方法並指定所需的檔案路徑來儲存 PDF。

哪裡可以下載 IronPDF 庫？

您可以從 NuGet 下載 IronPDF C# 庫。為此，請造訪 NuGet 網站並搜尋 IronPDF 以找到該軟體包。

如何將包含外部資源的 HTML 字串渲染成 PDF？

IronPDF 允許透過設定BaseUrlOrPath屬性來渲染包含外部資源的 HTML。您可以從指定的 URL 或路徑載入圖片、CSS 和 JavaScript，並將它們渲染到 PDF 中。

IronPDF 與 .NET 10 相容嗎？

是的－IronPDF 完全支援 .NET 10，以及 .NET 9、8、7、6 和 .NET Core。它無需任何特殊配置即可在 .NET 10 專案中開箱即用。支援的平台包括 Windows、Linux、macOS 和容器化環境。

Regan Pun
Regan Pun
  立即與工程團隊聊天
軟體工程師
Regan畢業於雷丁大學，獲得電子工程學士學位。在加入Iron Software之前，他的職位讓他專注於單一任務；而在Iron Software，他最享受的是能夠參與各種不同的工作，不論是增加銷售價值、技術支援、產品開發或行銷。他喜歡了解開發者使用Iron Software庫的方式，並利用這些知識來不斷完善文檔和開發產品。
準備好開始了嗎？
Nuget 下載 16,133,208 | 版本： 2025.11 剛剛發布