1. IronPDF
  2. 操作指南
  3. 建立新 PDF 檔案

如何使用IronPDF在 C# 中建立新的 PDF 文件

Curtis Chau
Curtis Chau
更新:
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 生成工具。

請注意上次在 AMD Ryzen 7 5800U 工作站（8 核心/16 線程，16 GB 內存，Windows 11， .NET 8， IronPDF 2025.12.2）上驗證。 PdfDocument 建構子 API 在支援的執行階段（.NET Framework 4.6.2+、. .NET Core 3.1+、. .NET 5 及更高版本）中保持一致，但舊版執行時間的效能會與下列基準測試結果有所不同。

快速入門：用 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. using 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

最簡工作流程（5個步驟）

  1. 從NuGet下載IronPDF以建立新的 PDF 檔案。
  2. 使用PdfDocument建構函數建立一個空白 PDF
  3. 從文件、URL、位元組數組或 JSON 匯入現有 PDF 文件
  4. 將多種格式轉換為 PDF，例如 HTML、RTF、Markdown、圖片和 XML。
  5. 匯出 PDF 文件


如何建立空白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 創建進行基準測試

指標 空白A4紙 A4 + 元數據 A4（10頁） 信 自訂（270×270）
平均創建時間 266.6毫秒 279.4毫秒 287.2毫秒 262.4毫秒 280.6毫秒
輸出檔案大小 0.60 KB 3.82 KB 1.79 KB 0.60 KB 0.60 KB
每次都呼叫記憶體 1.62 MB 1.61 MB 1.64 MB 1.61 MB 1.62 MB
產生的頁面 1 1 10 1 1

請注意上表顯示了當您改變頁面尺寸、新增元資料或合併多個空白頁面時，程式碼片段的效能。 每個變體都在其自身的進程中運行； 數值取自預熱後 5 次迭代的平均值。

從這些基準測試中可以合理推斷，在所有測試版本中，平均建立時間保持在 260-290 毫秒以內。 建立空白 PDF 後，您可以透過新增頁首和頁尾、套用浮水印或插入影像來增強它。

如何從文件匯入PDF？

在修改或轉換 PDF 檔案之前，必須先將其作為 PdfDocument 物件匯入。 使用 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

警告需要注意的一點：在原始碼中堅持使用現代 HTML5。 我嘗試重複使用從一些舊靜態網站和老舊的 gist 中提取的標記，但語法不匹配確實導致佈局故障，不僅在IronPDF中，而且在我嘗試過的每個基於 Chromium 的渲染器中都是如此。 如果出現渲染異常，請先使用 HTML 驗證器檢查 HTML。

哪些格式可以轉換為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
  立即與工程團隊聯繫
技術撰稿人

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

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

準備開始了嗎？
Nuget 下載 19,014,616 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

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