使用 IRONPDF

.NET Core PDF 庫

已更新 2024年1月21日

IronPDF 適用於 Microsoft Windows .NET Framework 4.x，以及最近發布的 .NET Core 3.1 和 .NET 最新版本。

IronPDF for .NET Core 可透過 NuGet 官方頁面獲取NuGet 上的 IronPdf 套件.

目前的 .NET Core 版本跨平台支援 Linux、Unix 和 macOS 客戶端操作系統，以及 mono，MAUI 和 Blazor 相容性.

現有和新客戶在其現有的支持與升級覆蓋範圍內可免費升級到IronPDF的.NET Core版本。隨附每個IronPDF 商業授權. 這確保了您在 IronPDF 上的投資未來可持續發展。

現有客戶如希望延長已過期的支持和更新覆蓋，可以購買 IronPDF 授權的延伸選項.

IronPDF：一個 .NET PDF 庫

IronPDF 是一個 C# PDF 函式庫，可用於 .NET Core 專案中。它提供了所有必要的 API，以便直接且直觀地操作 PDF 文件。市場上還有其他 PDF 生成庫，但這個庫的設計盡可能簡單，以避免混淆。

這個專案的主要目標是為 .NET 應用程式提供一個 PDF 庫。它具備許多實用功能，例如從 HTML 字串生成 PDF 文件、將 PDF 轉換為其他格式、操作現有的 PDF 文檔，並直接從 .NET Core 項目生成 PDF 文件。 IronPDF 函式庫也提供了只需幾行程式碼即可列印 PDF 檔案的功能。 IronPDF 可以用作 PDF 轉換器。它可以使用其易於訪問的功能創建多頁面展開表格。

讓我們開始在專案中使用IronPDF庫。

建立 C# 專案

建議使用最新版本的 Visual Studio 來建立此 .NET 專案，以確保順暢的使用體驗。 IronPDF庫也兼容於.NET Core專案。選擇取決於使用者，因為在所有 .NET Framework 上安裝和使用 IronPDF 是完全相同的。請按照以下步驟在 Visual Studio 中創建項目。

啟動 Visual Studio。
點擊「創建新專案」。
在 Visual Studio 中創建一個新專案
在搜尋欄中搜尋「Console」，並從搜尋結果中選擇帶有 C# 標籤的「Console App」。
控制台應用程式選擇
之後，根據您的需求配置專案名稱。
配置這個新應用程式
之後，從下拉列表中選擇最新版本的 .NET Framework。這是推薦的選擇。接下來，點擊建立按鈕。
.NET Framework 選擇
該專案現在將被創建。您也可以將現有的 .NET Core 專案與 IronPDF 結合使用。首先，您需要安裝該程式庫。下一部分顯示如何安裝程式庫。

IronPDF 庫的安裝

IronPDF 函式庫可以從控制台安裝。只需在控制台中寫下以下這行代碼，然後按 Enter。

Install-Package IronPdf

您可以在 IronPDF 網站上獲取更多信息和IronPDF NuGet 頁面.

安裝後，您將能夠在您的.NET專案中使用它。如需有關安裝的更多詳情，請訪問IronPDF 安裝指南.

範例程式碼

用於 PDF 文件的網頁

using IronPdf;

var renderer = new ChromePdfRenderer();
//Choose Screen or Print CSS media
renderer.RenderingOptions.CssMediaType = Rendering.PdfCssMediaType.Screen;

//Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1280;
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A2;

var pdf = renderer.RenderUrlAsPdf("https://www.amazon.com/");
pdf.SaveAs("Amazon.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();
//Choose Screen or Print CSS media
renderer.RenderingOptions.CssMediaType = Rendering.PdfCssMediaType.Screen;

//Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1280;
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A2;

var pdf = renderer.RenderUrlAsPdf("https://www.amazon.com/");
pdf.SaveAs("Amazon.pdf");

Imports IronPdf

Private renderer = New ChromePdfRenderer()
'Choose Screen or Print CSS media
renderer.RenderingOptions.CssMediaType = Rendering.PdfCssMediaType.Screen

'Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1280
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A2

Dim pdf = renderer.RenderUrlAsPdf("https://www.amazon.com/")
pdf.SaveAs("Amazon.pdf")

VB C#

此示例顯示如何將複雜的網站 UI 轉換為 PDF，例如：Amazon 網站，按照以下步驟：

將媒體類型設置為螢幕
設置視口寬度
設定輸出 PDF 的紙張大小。頁面大小是 PDF 文件中的一個重要因素。
將 URL 渲染為 PDF，來源為 Amazon URL。

輸出

.NET Core PDF 庫, 圖 5：從 Amazon 網站生成的輸出 PDF 文件

從 Amazon 網站生成的 PDF 文件

簡單的 PDF 創建

using IronPdf;

// Instantiate renderer
var renderer = new IronPdf.ChromePdfRenderer();

// Create a PDF from a HTML string using C#
using var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

/****** Advanced Example with HTML Assets ******/
// Load external html assets: images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
using var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");

pdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Instantiate renderer
var renderer = new IronPdf.ChromePdfRenderer();

// Create a PDF from a HTML string using C#
using var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

/****** Advanced Example with HTML Assets ******/
// Load external html assets: images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
using var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");

pdf.SaveAs("html-with-assets.pdf");

Imports IronPdf

' Instantiate renderer
Private renderer = New IronPdf.ChromePdfRenderer()

' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

' Export to a file or Stream
pdf.SaveAs("output.pdf")

'''**** Advanced Example with HTML Assets *****
' Load external html assets: images, CSS and JavaScript.
' An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
Dim myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")

pdf.SaveAs("html-with-assets.pdf")

VB C#

上面的代碼演示了如何使用IronPDF的HTML到PDF功能。要使用 IronPDF，必須匯入命名空間。在程式檔案的最上方撰寫 using IronPdf; 以在專案中使用它。

這ChromePdfRenderer物件提供網頁支援。這RenderHtmlAsPdf函數可用於將 HTML 字串轉換為 PDF 文件。函數參數接受各種類型的來源，包括 HTML 字串。您可以通過設置圖片的基礎路徑，在您的 PDF 文件中使用圖片。接下來，使用 SaveAs 函數將 PDF 文件儲存在本地機器上。您可以選擇上面的簡單 HTML 並結合 CSS、圖像和 JavaScript。

輸出

.NET Core PDF庫，圖6：PDF檔案輸出自Hello World HTML文字

從 Hello World HTML 文本輸出 PDF 文件

頁首和頁尾

renderer.RenderingOptions.FirstPageNumber = 1; // use 2 if a coverpage will be appended
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "{url}";
renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica;
renderer.RenderingOptions.TextHeader.FontSize = 12;

renderer.RenderingOptions.FirstPageNumber = 1; // use 2 if a coverpage will be appended
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "{url}";
renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica;
renderer.RenderingOptions.TextHeader.FontSize = 12;

renderer.RenderingOptions.FirstPageNumber = 1 ' use 2 if a coverpage will be appended
renderer.RenderingOptions.TextHeader.DrawDividerLine = True
renderer.RenderingOptions.TextHeader.CenterText = "{url}"
renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica
renderer.RenderingOptions.TextHeader.FontSize = 12

VB C#

上述範例展示了如何在 PDF 文件中設置頁眉和頁腳。IronPDF 支持在文檔中重複頁眉。 IronPDF 提供 TextHeader 和 TextFooter 屬性來設定文字的多個屬性，例如字體、文字位置等。它還可以將 HTML 文件轉換為 PDF 文件。這對IronPDF來說一切都很簡單。它也可以高效合併 PDF 文件執行將網頁轉換為 PDF, 啟用自動頁碼，和為 PDF 創建數位簽章使用 IronPDF。此外，它生成 PDF 檔案的最小文件大小與高效壓縮.

摘要

IronPDF 是一個完整的 PDF 函式庫，支援所有最新版本的 .NET Core 和 .NET Framework。 IronPDF 基於一種商業模式，提供使用 IronPDF 函式庫創建和編輯商業文件的安全方式。其進階功能使使用者能夠在 .NET Core 專案中創建動態且富創意的 PDF 文件。您可以選擇嘗試免費試用版進行生產測試。

.NET Core PDF 庫，圖7：IronPDF Professional license