IronPDF 快速入門指南

This article was translated from English: Does it need improvement?
Translated
View the article in English

安裝 IronPDF,只需五分鐘即可建立您的第一個 PDF 檔案。憑藉其簡潔易用的 API,您可以將 HTML、DOCX、圖像等多種格式的檔案轉換為像素級完美的 PDF 檔案。

1. 先決條件


2. 安裝 IronPDF

標準版 IronPDF 安裝程式在本地運行。 如果您想在 Docker/微服務上進行部署,請查看遠端引擎模式指南

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 請複製並執行此程式碼片段。

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. 部署至您的生產環境進行測試

    立即透過免費試用,在您的專案中開始使用 IronPDF

    arrow pointer
NuGet 套件管理器
DLL 下載

前往IronPDF NuGet 庫:

  1. 在解決方案資源管理器中,以滑鼠右鍵按一下"引用"。
  2. 選擇'管理NuGet package' > 'Browse' > 搜尋IronPDF
Install-Package IronPdf
  • 下載IronPDF DLL 套件 將適用於您作業系統的 ZIP 檔案解壓縮到解決方案目錄中的某個位置。
  • 在 Visual Studio 解決方案資源管理器中,以滑鼠右鍵按一下"依賴項"。
  • "新增項目引用" > 選擇"瀏覽"以包含從 zip 檔案中提取的所有 DLL 檔案。

平台專屬指南


3. 應用許可證密鑰

當您購買IronPDF 授權或選擇開始 30 天試用期時,許可證金鑰將會傳送到您的電子郵件。 複製密鑰並將其添加到應用程式的開頭。

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

4. 創建你的第一個PDF

將此程式碼新增至您的 .cs 檔案頂部。

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel
建立空白 PDF
將 HTML 字串轉換為 PDF
將 DOCX 轉換為 PDF

創建PDF對象的最簡單方法只是使用寬度和高度。 此 PdfDocument 建構函式會建立一個空白 PDF 檔案,可供後續自訂。

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf

Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
$vbLabelText   $csharpLabel

透過 ChromePdfRenderer.RenderHtmlAsPdf 方法,您可以利用內建的 Chromium 引擎,將任何 HTML(包括 HTML5)轉換為 PDF。

using IronPdf;

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

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

IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
$vbLabelText   $csharpLabel

using DocxToPdfRenderer 類別將 WORD 文件轉換為 PDF,您可以直接將 DOCX 檔案渲染為可自訂的 PDF,以便無縫整合至 .NET 應用程式中。

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
$vbLabelText   $csharpLabel

5. 更多進階範例

除了簡單的 PDF 建立和轉換功能外,IronPDF 還提供更強大的 PDF 自訂選項。

新增頁首和頁尾
編輯文字
合併PDF

透過實例化 TextHeaderFooter、加入您的文字,並將其附加至 PDF 檔案,即可建立文字頁首或頁尾。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")
$vbLabelText   $csharpLabel

using RedactTextOnAllPages 輕鬆遮蔽文字,以在整份文件中移除特定短語。

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");
Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")
$vbLabelText   $csharpLabel

using Merge 方法在 C# 中合併兩個 PDF 檔案。 請在任何 PdfDocument(無論是新增或匯入的)上使用 ReplaceTextOnAllPages,以將舊文字替換為新文字。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")
$vbLabelText   $csharpLabel

快速故障排除

問題 解決方案
缺少 Visual C++ 運行時 安裝 Visual C++ 可再發行元件套件-Chrome 引擎需要 x86 和 x64 版本。
許可證未識別 使用IronPdf.License.IsLicensed屬性進行驗證。確保在執行任何 IronPDF 操作之前套用許可證。
慢速首次渲染 啟動時呼叫IronPdf.Installation.Initialize()以預初始化渲染引擎
Linux/Docker 依賴項 設定Installation.LinuxAndDockerDependenciesAutoConfig = true以自動安裝依賴項

後續步驟


常見問題

如何設定 IronPdfEngine 以進行遠端 PDF 生成?

若要設定 IronPdfEngine 以進行遠端 PDF 生成,請從 NuGet 安裝 IronPdf.Slim 套件,並使用 IronPdfConnectionConfiguration 類別配置連線設定。此設定可讓您的應用程式遠端連線至 IronPdfEngine 實例。

在我的應用程式中使用 IronPdfEngine 有哪些主要優勢?

在您的應用程式中使用 IronPdfEngine,可實現 PDF 任務的遠端執行,有助於避免平台特定的相容性問題,特別是在舊版系統和行動平台上。此外,執行時亦無需 .NET 執行環境。

為什麼我會選擇使用 IronPdfEngine 而不是原生 PDF 函式庫?

您可選用 IronPdfEngine 來遠端執行效能密集型的 PDF 功能,藉此減少與不同作業系統的相容性問題,並透過採用與 Chrome 相同的渲染器進行 HTML 轉 PDF 轉換,從而提升效能。

IronPdfEngine 是否支援水平擴展?

不,IronPdfEngine 目前不支援水平擴展,這意味著由於伺服器記憶體中處理 PDF 檔案二進位檔的方式,無法在多個執行個體之間進行負載平衡。

IronPdfEngine 能否在不同的作業系統上運行?

IronPdfEngine 設計用於透過 Docker 容器在 Linux 系統上運行。然而,二進位檔具有平台專屬性,因此您需確保使用與您的作業系統相容的正確版本。

若使用 IronPdfEngine 時產生的 PDF 輸出結果與預期不同,我該怎麼辦?

由於不同作業系統的運作行為差異,PDF 輸出結果可能會略有不同。為盡量減少差異,請確保您使用的是正確的 Docker 映像檔,並檢查任何可能影響渲染的作業系統特定設定。

如何確保我的應用程式使用的是正確版本的 IronPdfEngine?

為確保相容性,IronPDF 的每個版本都需要對應的 IronPdfEngine 版本。請務必同時更新這兩項元件,以避免跨版本問題。

在 Windows 上使用 IronPdfEngine 時有哪些限制?

在 Windows 系統上使用 IronPdfEngine 時,您需要 Docker 的 Linux 容器,並須確保伺服器埠可被存取。二進位檔具有平台專屬性,因此必須切換至 Linux 容器。

如何設定 IronPDF 以連線至遠端的 IronPdfEngine 伺服器?

若要為遠端伺服器設定 IronPDF,請使用 Installation.ConnectToIronPdfHost 並搭配 IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer 方法,同時指定伺服器的 IP 位址與連接埠詳細資訊。

使用 IronPdfEngine 時,應選用哪種套件才能將應用程式大小降至最低?

您應使用 NuGet 上的 IronPdf.Slim 套件,因為它僅包含使用 IronPdfEngine 執行 IronPDF 所需的必要元件,從而減小應用程式大小。

Curtis Chau
技術撰稿人

Curtis Chau 擁有卡爾頓大學(Carleton University)的電腦科學學士學位,專精於前端開發,並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面,喜歡運用現代框架,並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外,Curtis 對物聯網(IoT)抱有濃厚興趣,致力於探索整合硬體與軟體的創新方法。閒暇時,他喜歡玩遊戲和開發 Discord 機器人,將對科技的熱愛與創意相結合。

準備開始了嗎?
Nuget 下載 18,918,602 | 版本: 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎?

想要快速確認成果嗎? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。