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

Q: 建立空白PDF文件的最快方法是什麼？

使用IronPDF建立空白PDF的最快方法是使用帶有寬度和高度參數的 PdfDocument 構造函式： new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf') 。尺寸以點數為單位（1/72英寸）。您還可以設置自定義頁面尺寸、方向，並新增例如作者和標題的元資料。

Q: 我可以將HTML內容轉換為PDF格式嗎？

是的，IronPDF擅長使用 ChromePdfRenderer 類轉換HTML為PDF。只需建立一個渲染器實例，使用 RenderHtmlAsPdf() 方法： var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('<h1>Hello PDF!</h1>') 。這支持完整的HTML5、CSS3和JavaScript渲染。

Q: 如何將自定義元資料新增到我的PDF文件？

建立 PdfDocument 後，通過IronPDF存取 MetaData 屬性以設置自定義資訊： pdf.MetaData.Author = '您的姓名'; pdf.MetaData.Title = '文件標題'; pdf.MetaData.CreationDate = DateTime.Now. 這些元資料有助於文件組織和可搜索性。

Q: 我可以從不同來源導入現有PDF嗎？

IronPDF允許從多種來源導入現有PDF，包括本地文件、URL、位元組陣列或JSON資料。對於本地文件使用 PdfDocument.FromFile() ，對於基於網頁的PDF使用 FromUrl() ，對於位元組資料使用 FromBytes() 。這使您能夠使用並修改現有的PDF文件。

Q: 如何向PDF文件新增多個頁面？

在您的 PdfDocument 物件上使用 AppendPage() 方法動態新增空白頁面。IronPDF還支持在特定位置插入頁面，從其他PDF中復制頁面，以及合併多個PDF文件。每個新頁面都繼承預設頁面尺寸，除非另行指定。

Q: How do I set the title and author of a PDF in IronPDF?

Set the properties on `MetaData`, such as `Title`, `Author`, `Subject`, `Keywords`, `CreationDate` and `ModifiedDate`, before saving.

Curtis Chau

Updated: 2026年6月4日

IronPDF讓C#開發者可以透過使用PdfDocument建構子來程式化地建立空白PDF，從各種來源匯入現有的PDF，或將HTML、圖像、RTF、Markdown和XML轉換為PDF格式。無論是構建商業報告、生成發票，還是從網路內容建立動態文件，IronPDF都提供了在.NET應用程式中生成PDF的工具。

請注意: 最後驗證於AMD Ryzen 7 5800U工作站（8核心/16執行緒，16 GB RAM，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 page, 270 by 270 millimetres
var pdf = new IronPdf.PdfDocument(270, 270);

// 3. Draw text on the first page, X and Y in points from the bottom-left corner
pdf.DrawText("Hello PDF!", IronSoftware.Drawing.FontTypes.TimesNewRoman.Name, FontSize: 18, PageIndex: 0, X: 40, Y: 120, IronSoftware.Drawing.Color.Black, Rotation: 0);

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");

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

// 3. Draw text on the first page, X and Y in points from the bottom-left corner
pdf.DrawText("Hello PDF!", IronSoftware.Drawing.FontTypes.TimesNewRoman.Name, FontSize: 18, PageIndex: 0, X: 40, Y: 120, IronSoftware.Drawing.Color.Black, Rotation: 0);

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2複製並運行這段程式碼片段。

new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf");

new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf");

New IronPdf.PdfDocument With {.DefaultPageSize = New IronPdf.PageSize(270, 270)}.SaveAs("blankPage.pdf")

New IronPdf.PdfDocument With {.DefaultPageSize = New IronPdf.PageSize(270, 270)}.SaveAs("blankPage.pdf")

3部署以在您的實時環境中測試

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

最小工作流程 (5步)

從NuGet下載IronPDF以建立新PDF
使用PdfDocument建構子來建立一個空白PDF
從文件、URL、位元組陣列或JSON匯入現有的PDF
將多種格式轉換為PDF，例如HTML、RTF、Markdown、圖像和XML
匯出PDF文件

建立空白PDF範例

有多種方法可以建立PDF物件。從最簡單的方法開始，只需要PDF的寬度和高度。這個PdfDocument建構子會建立一個新的空白PDF，準備進行自定義和使用。尺寸以點（1/72英寸）來指定，能夠精確調整大小以適應各種應用程式，如標籤、名片或自定義文件格式。

對於需要更多控制頁面尺寸的開發者，IronPDF支援自定義紙張尺寸和各種預定義格式，包括Letter、A4和Legal尺寸。您可以利用頁面方向功能設定不同的方向。

建立空白PDF需要哪些參數？

using IronPdf;

// Create a blank page, width and height in millimetres
PdfDocument pdf = new PdfDocument(270, 270);

pdf.SaveAs("blankPage.pdf");

using IronPdf;

// Create a blank page, width and height in millimetres
PdfDocument pdf = new PdfDocument(270, 270);

pdf.SaveAs("blankPage.pdf");

在不同配置下的PDF建立基準

指標	空白A4	A4 + 元資料	A4（10頁）	Letter	自定義（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方法來實現這一點。在同一類別中支援從JSON、位元組陣列、流和URL匯入PDF。此靈活性適合需要合併多個PDF、提取指定頁面或修改現有文件的情況。

當處理儲存在雲端服務上的PDF時，IronPDF與Azure Blob Storage及其他雲端平台整合。您可以從記憶體流中載入PDF，以便在不存取檔案系統的情況下進行高效處理。

有哪些匯入方法可用？

using IronPdf;

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

pdf.SaveAs("export.pdf");

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")

Imports IronPdf

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

pdf.SaveAs("export.pdf")

匯入後，您可以執行各種操作，如提取文字和圖像、新增註解或應用數位簽章。

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

我要如何從其他格式轉換？

除了前面提到的獲取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。

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

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");

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")

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")

警告: 需要注意的一件事：請在源中使用現代的HTML5。我嘗試重用從一些遺留的靜態網站和老舊的gists拉來的標記，並發現不匹配的語法不僅在IronPDF中，而在我嘗試的每一個基於Chromium的渲染器中都會導致佈局問題。如果某些東西渲染異常，請首先將HTML通過驗證器。)]

哪些格式可以轉換為PDF？

IronPDF支援從多種格式轉換：

HTML轉PDF：轉換HTML字串、HTML文件，或URLs，具備完整的CSS和JavaScript支援
圖片轉PDF：轉換JPG、PNG、GIF、BMP和TIFF圖片
文件格式：轉換DOCX和RTF文件
標記語言：轉換Markdown和XML
ASP.NET頁面：轉換ASPX和Razor頁面

生成的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('<h1>Hello PDF!</h1>')。這支持完整的HTML5、CSS3和JavaScript渲染。

可以轉換哪些文件格式為PDF？

IronPDF支持將多種格式轉換為PDF，包括HTML、圖片（JPG、PNG、GIF、BMP）、RTF文件、Markdown文件和XML。每種格式都有特定的方法-例如，對於HTML使用RenderHtmlAsPdf()，對於圖片使用ImageToPdf()，以及特殊的渲染器處理其他格式。

如何將自定義元資料新增到我的PDF文件？

建立PdfDocument後，通過IronPDF存取MetaData屬性以設置自定義資訊：pdf.MetaData.Author = '您的姓名'; pdf.MetaData.Title = '文件標題'; pdf.MetaData.CreationDate = DateTime.Now.這些元資料有助於文件組織和可搜索性。

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

IronPDF允許從多種來源導入現有PDF，包括本地文件、URL、位元組陣列或JSON資料。對於本地文件使用PdfDocument.FromFile()，對於基於網頁的PDF使用FromUrl()，對於位元組資料使用FromBytes()。這使您能夠使用並修改現有的PDF文件。

如何向PDF文件新增多個頁面？

在您的PdfDocument物件上使用AppendPage()方法動態新增空白頁面。IronPDF還支持在特定位置插入頁面，從其他PDF中復制頁面，以及合併多個PDF文件。每個新頁面都繼承預設頁面尺寸，除非另行指定。

支持哪些頁面尺寸和方向？

IronPDF支持以點數指定的自定義紙張尺寸，以及預定義格式如Letter，A4和Legal。您可以設置頁面方向（縱向或橫向）並建立具有混合頁面尺寸的文件。自定義尺寸為您提供精確的控制，適用於標籤或名片等特殊應用。

How do I set the title and author of a PDF in IronPDF?

Set the properties on MetaData, such as Title, Author, Subject, Keywords, CreationDate and ModifiedDate, before saving.

How fast is creating a blank PDF with IronPDF?

Creating a blank PDF with IronPDF is efficient, taking approximately 260-290 ms depending on the page dimensions and whether metadata or multiple pages are included.

Should I build from scratch or use an HTML template for tickets, labels or invoices?

Draw from scratch when every element sits at a fixed position, as on tickets and labels. Use an HTML template rendered with ChromePdfRenderer when the content changes length, as invoice line items do, because HTML wraps text and breaks tables across pages.