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# 開發人員使用 PdfDocument 建構器以程式化的方式建立新的 PDF 文件，以建立空白的 PDF 文件、從各種來源匯入現有的 PDF 文件，或將 HTML、圖片、RTF、Markdown 和 XML 轉換為 PDF 格式。 無論是建立商業報表、產生發票，或是從網頁內容建立動態文件，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？

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

在處理儲存在雲端服務中的 PDF 時，IronPDF 整合了 Azure Blob Storage 和其他雲端平台。 您可以從記憶體流載入 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 架構，因此適合將複雜的網頁或 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 bots，將他對技術的熱愛與創意結合。

準備好開始了嗎？
Nuget 下載 17,570,948 | 版本： 2026.2 剛剛發布