1. IronPDF
  2. 操作指南
  3. 創建新PDF

如何使用 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");
$vbLabelText   $csharpLabel

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

  1. 使用 NuGet 套件管理器安裝 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 的寬度和高度。 此PdfDocument建構函數會建立一個新的空白 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");
$vbLabelText   $csharpLabel

建立空白 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");
$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");
$vbLabelText   $csharpLabel

哪些格式可以轉換為PDF？

IronPDF支援多種格式的轉換：

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

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

常見問題解答

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

透過 Visual Studio 中的 NuGet Package Manager 安裝 IronPDF。您可以在 NuGet Package Manager UI 中搜尋「IronPDF」，或使用 Package Manager Console，執行指令「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 = 'Your Name'；pdf.MetaData.Title = 'Document Title'；pdf.MetaData.CreationDate = DateTime.Now。這些元資料有助於文件的組織和可搜尋性。

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

IronPDF 允許從各種來源匯入現有的 PDF，包括本機檔案、URL、位元組陣列或 JSON 資料。本地文件使用 PdfDocument.FromFile()，基於 Web 的 PDF 使用 FromUrl()，位元組數據使用 FromBytes()。這使您能夠處理和修改現有的 PDF 文件。

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

使用 PdfDocument 物件上的 AppendPage() 方法動態添加空白頁。IronPDF 還支援在特定位置插入頁面、從其他 PDF 複製頁面，以及將多個 PDF 文件合併在一起。除非另有指定，否則每個新頁面都會繼承預設的頁面大小。

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

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

柯蒂斯·週
柯蒂斯·週
  現在就和工程團隊聊天吧
技術撰稿人

Curtis Chau擁有卡爾頓大學電腦科學學士學位，專長於前端開發，精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面，喜歡使用現代框架，並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

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

準備好開始了嗎？
Nuget 下載 17,012,929 | 版本： 2025.12 剛剛發布