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 生成工具。

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

  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

最簡工作流程(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");
$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");
$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
Curtis Chau
  立即與工程團隊聊天
技術作家

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

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

準備好開始了嗎？
Nuget 下載 17,803,474 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎？

想快速取得證據？ PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。