如何使用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文件。每個新頁面都繼承預設頁面尺寸，除非另行指定。

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

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

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

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;

PdfDocument pdf = new PdfDocument(270, 270);

pdf.SaveAs("blankPage.pdf");

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

Imports IronPdf

Dim pdf As 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 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.

Can IronPDF handle legacy HTML markup in conversions?

IronPDF, like other Chromium-based renderers, can encounter layout issues with legacy HTML. It's recommended to validate HTML before conversion for better results.