如何使用 IronPDF 在 C# 中建立與編輯 PDF 文件

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

IronPDF使 C# 開發人員能夠透過程式設計建立新的 PDF 文檔,使用 PdfDocument 建構函數建立空白 PDF,從各種來源匯入現有 PDF,或將 HTML、圖像、RTF、Markdown 和 XML 轉換為 PDF 格式。 無論是建立業務報告、產生發票,還是從 Web 內容建立動態文檔, IronPDF為.NET應用程式提供了 PDF 生成工具。

快速入門:用 C# 創建你的第一個 PDF

// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);

// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);

// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New IronPdf.PdfDocument(270, 270)

' 3. Or convert HTML to PDF
Dim renderer As New IronPdf.ChromePdfRenderer()
Dim pdfFromHtml As IronPdf.PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")

' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")
$vbLabelText   $csharpLabel
  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 複製並運行這段程式碼。

    new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf");
  3. 部署到您的生產環境進行測試

    今天就在您的專案中開始使用免費試用IronPDF

    arrow pointer


如何建立空白PDF範例?

建立 PDF 物件的方法有很多種。 首先從最簡單的方法入手,這種方法只需要 PDF 的寬度和高度。 此建構函式會建立一個新的空白 PDF,可供自訂和使用。 尺寸以點(1/72 英吋)為單位,可針對標籤、名片或自訂文件格式等各種應用進行精確尺寸調整。

對於需要更好地控制頁面尺寸的開發人員, IronPDF支援自訂紙張尺寸和各種預訂格式,包括 Letter、A4 和 Legal 尺寸。 您可以使用頁面方向功能設定不同的方向。

空白PDF需要哪些參數?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs.cs
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

建立空白 PDF 後,您可以透過新增頁首和頁尾套用浮水印插入影像來增強它。


如何從文件匯入PDF?

在修改或轉換 PDF 之前,必須先將其作為 PdfDocument 物件匯入。 使用 FromFile 類別的靜態方法來實現此目的。 同一類別支援從 JSON、位元組數組、流和 URL 匯入 PDF。 這種靈活性適用於需要合併多個 PDF 、提取特定頁面或修改現有文件的場景。

當處理儲存在雲端服務中的 PDF 檔案時, IronPDF可以與Azure Blob 儲存和其他雲端平台整合。 您可以直接從記憶體流載入 PDF 文件,無需存取文件系統即可進行高效處理。

有哪些導入方式可供選擇?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-file.cs
using IronPdf;

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

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

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

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

匯入後,您可以執行各種操作,例如提取文字和圖像新增註釋套用數位簽章


如何從其他格式轉換?

除了前面提到的獲取 PdfDocument 物件的方法外,您還可以將各種格式轉換為 PDF。 最複雜的方法是將 HTML 轉換為 PDF,它會使用 Chrome 引擎渲染 HTML 及其所有資源,包括JavaScript、圖像、連結和 CSS 樣式。除了 HTML,您還可以將其他格式轉換為 PDF,例如圖片、RTF、Markdown 和 XML。

IronPDF 的Chrome 渲染引擎可確保像素級完美轉換,以保持來源內容的視覺保真度。 此渲染器支援包括 HTML5、CSS3 和JavaScript框架在內的現代 Web 標準,使其適用於將複雜的網頁或Razor視圖轉換為 PDF。

以下程式碼片段示範如何將 HTML 轉換為 PDF。 HTML 轉換使用 IronPDF 的渲染引擎來保持內容完整性,並套用所有樣式。 您也可以將Markdown 轉換為 PDF將 XML 轉換為 PDF ,以及將圖片轉換為 PDF

我應該配置哪些渲染選項?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-html.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800);
renderer.RenderingOptions.WaitFor.RenderDelay(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Create a PDF from a URL or local file path
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

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

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800)
renderer.RenderingOptions.WaitFor.RenderDelay(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

' Create a PDF from a URL or local file path
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")

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

哪些格式可以轉換為PDF?

IronPDF支援多種格式的轉換:

產生的 PDF 檔案可以使用嵌入式 PDF 檢視器查看,如下圖所示。 下面的 iframe 會顯示輸出的 PDF 檔案。

對於進階場景,可以探索渲染 WebGL 網站、處理JavaScript延遲或實作自訂日誌記錄以排查轉換問題。

常見問題解答

如何安裝函式庫以開始使用 C# 建立 PDF?

請透過 Visual Studio 中的 NuGet 套件管理員安裝 IronPDF。您可以在 NuGet 套件管理員介面中搜尋「IronPDF」,或透過套件管理員控制台執行「Install-Package IronPdf」指令。安裝完成後,您即可立即使用 PdfDocument 建構函式或 ChromePdfRenderer 類別開始建立 PDF 檔案。

建立空白 PDF 文件的最快方法是什麼?

使用 IronPDF 建立空白 PDF 的最快方法,是透過 PdfDocument 建構函式並指定寬度和高度參數:new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf')。尺寸以點(1/72 英吋)為單位指定。您也可以設定自訂的頁面大小、方向,並新增作者和標題等元資料。

我可以將 HTML 內容轉換成 PDF 格式嗎?

是的,IronPDF 擅長透過 ChromePdfRenderer 類別進行 HTML 轉 PDF 轉換。只需建立一個渲染器實例,並使用 RenderHtmlAsPdf() 方法即可:var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('

Hello PDF!

')。此功能支援完整的 HTML5、CSS3 及 JavaScript 渲染。

哪些檔案格式可以轉換成 PDF?

IronPDF 支援將多種格式轉換為 PDF,包括 HTML、圖像(JPG、PNG、GIF、BMP)、RTF 文件、Markdown 檔案及 XML。每種格式都有專屬的方法——例如,HTML 使用 RenderHtmlAsPdf(),圖像使用 ImageToPdf(),其他格式則使用專用的渲染器。

如何在 PDF 文件中加入自訂元資料?

使用 IronPDF 建立 PDFDocument 後,請存取 MetaData 屬性以設定自訂資訊:pdf.MetaData.Author = '您的姓名';pdf.MetaData.Title = '文件標題';pdf.MetaData.CreationDate = DateTime.Now。這些元資料有助於文件的管理與檢索。

我可以從不同來源匯入現有的 PDF 嗎?

IronPDF 允許從各種來源匯入現有 PDF 文件,包括本地檔案、URL、位元組陣列或 JSON 資料。請使用 PdfDocument.FromFile() 處理本地檔案、FromUrl() 處理網路上的 PDF,或 FromBytes() 處理位元組陣列資料。這使您能夠處理並修改現有的 PDF 文件。

如何在 PDF 文件中加入多頁?

請使用 PdfDocument 物件的 AppendPage() 方法來動態新增空白頁面。IronPDF 亦支援在特定位置插入頁面、從其他 PDF 檔案複製頁面,以及合併多個 PDF 文件。除非另有指定,否則每個新頁面都會繼承預設的頁面大小。

支援哪些頁面大小和方向?

IronPDF 支援以點為單位指定的自訂紙張尺寸,以及預先定義的格式,如 Letter、A4 和 Legal。您可以設定頁面方向(縱向或橫向),並建立混合頁面尺寸的文件。自訂尺寸可讓您精確控制專門的應用程式,例如標籤或名片。

Curtis Chau
技術作家

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

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

準備好開始了嗎?
Nuget 下載 18,560,885 | 版本: 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎?

想要快速證明? PM > Install-Package IronPdf
執行範例 觀看您的 HTML 變成 PDF。