如何使用IronPDF在C#中建立新的PDF
IronPDF讓C#開發者可以透過使用PdfDocument建構子來程式化地建立空白PDF，從各種來源匯入現有的PDF，或將HTML、圖像、RTF、Markdown和XML轉換為PDF格式。 無論是構建商業報告、生成發票，還是從網路內容建立動態文件，IronPDF都提供了在.NET應用程式中生成PDF的工具。
PdfDocument建構子API在支援的運行時環境（.NET Framework 4.6.2+，.NET Core 3.1+，.NET 5及以後版本）上是一致的，但在舊的運行時環境上的性能將與下面的基準不同。快速入門：在C#中建立您的第一個PDF
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-1.cs// 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");
Imports IronPdf
' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New PdfDocument(270, 270)
' 3. Or convert HTML to PDF
Dim renderer As New ChromePdfRenderer()
Dim pdfFromHtml As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")
' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")
最小工作流程 (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需要哪些參數？
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs.csusing IronPdf;
PdfDocument pdf = 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 |
從這些基準測試中，可以安全地推導出平均建立時間在260-290毫秒範圍內。 一旦建立了空白PDF，您可以透過新增頁首和頁尾、應用水印或者插入圖像來增強它。
我要如何從文件匯入PDF？
在PDF可以修改或轉換之前，必須首先將其匯入為PdfDocument物件。 使用PdfDocument方法來實現這一點。 在同一類別中支援從JSON、位元組陣列、流和URL匯入PDF。 此靈活性適合需要合併多個PDF、提取指定頁面或修改現有文件的情況。
當處理儲存在雲端服務上的PDF時，IronPDF與Azure Blob Storage及其他雲端平台整合。 您可以從記憶體流中載入PDF，以便在不存取檔案系統的情況下進行高效處理。
有哪些匯入方法可用？
:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-file.csusing 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")匯入後，您可以執行各種操作，如提取文字和圖像、新增註解或應用數位簽章。
我要如何從其他格式轉換？
除了前面提到的獲取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.csusing 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")哪些格式可以轉換為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。您可以設置頁面方向（縱向或橫向）並建立具有混合頁面尺寸的文件。自定義尺寸為您提供精確的控制，適用於標籤或名片等特殊應用。
還在捲動嗎？
想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。
免費開始
免費開始
預訂免費直播演示
