IronPDF 快速入門指南

1. 先決條件

• .NET Framework 4.6.2+ 或 .NET Core 3.1+ 或 .NET 5+
• Visual C++ Redistributable （適用於 Windows）。

2. 安裝 IronPDF

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

前往IronPDF NuGet 庫：

1. 在解決方案資源管理器中，以滑鼠右鍵按一下"引用"。
2. 選擇"管理 NuGet 套件">"瀏覽">搜尋 IronPdf

Install-Package IronPdf

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

相關內容：更多關於配置設定的信息

平台專屬指南

Windows

Linux

MacOS

Docker

Azure

AWS

---

3. 應用許可證密鑰

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

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

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

查看 IronPDF 許可

4. 創建你的第一個PDF

IronPDF 可協助您建立 PDF 文件，或將 HTML、DOCX、RTF、Markdown 和映像轉換為 PDF，並保持文件格式的完整還原度。了解更多 PDF 轉換類型。

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

using IronPdf;

using IronPdf;

建立 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");

使用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");

相關教學：如何在 C# 中將 HTML 字串轉換為 PDF

使用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");

相關教學：如何在 C# 中將 Microsoft Word 轉換為 PDF

5. 更多進階範例

除了簡單的 PDF 建立和轉換功能外，IronPDF 還提供更強大的 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");

相關教學文章：如何新增頁首和頁腳

使用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");

相關教學：如何將 URL 渲染為 PDF

使用 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");

相關操作指南文章：如何合併或分割PDF文件

快速故障排除

後續步驟