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/微服務上進行部署,請查看遠端引擎模式指南

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 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 套件">"瀏覽">搜尋 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

使用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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

使用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

使用 C# 中的Merge方法合併兩個 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?

要為遠端 PDF 生成設定 IronPdfEngine,請從 NuGet 安裝 IronPdf.Slim 套件,並使用 IronPdfConnectionConfiguration 類設定連線設定。此設定可讓您將應用程式遠端連線至 IronPdfEngine 實例。

在我的應用程式中使用 IronPdfEngine 的主要好處是什麼?

將 IronPdfEngine 與您的應用程式搭配使用,可遠端執行 PDF 任務,有助於避免特定平台的相容性問題,尤其是在較舊的系統和行動平台上。在執行過程中也不需要 .NET runtime。

為什麼我會選擇使用 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 時,您需要 Linux Containers for Docker,並必須確保伺服器連接埠可以到達。二進位檔是特定平台的,需要切換到 Linux Containers。

如何配置 IronPDF 以連接到遠端 IronPdfEngine 伺服器?

要為遠端伺服器設定 IronPDF,請使用 Installation.ConnectToIronPdfHostIronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer 方法,指定伺服器的 IP 與連接埠詳細資訊。

在使用 IronPdfEngine 時,我應該使用何種套件來最小化應用程式的大小?

您應該使用 NuGet 中的 IronPdf.Slim 套件,因為它只包含使用 IronPdfEngine 執行 IronPDF 的必要元件,因此可縮小應用程式的大小。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 16,493,056 | Version: 2025.11 剛發表