C# 編程生成 PDF 文件

對於開發人員來說，存在許多需要以程式碼方式生成 PDF 檔案的情境。 您可能需要在您的軟體中以程式方式生成 PDF 報告和其他 PDF 文件。 從頭開始撰寫你的代碼和函數將會耗時、昂貴且效率低下。 這就是 IronPDF 派上用場的地方。 雖然在 .NET 中以程式方式創建 PDF 文件可能令人沮喪，但幸運的是，現在有了一個解決方案，使其變得更加易於管理。

教程涵蓋的主題

在本教程中，我們將涵蓋以下主題：

以程式創建 PDF 文件的步驟

• 步驟 1：建立一個 C# 專案

• 步驟 2：安裝IronPdf庫

  • 方法一：NuGet 套件管理員

  • 方法 2：NuGet 套件管理器主控台
• 方法三：使用 DLL 文件
• 步驟 3：加入 IronPdf 命名空間

• 步驟 4：以程式化方式建立 PDF 文件

  • 4.1：使用 HTML 字串以程式化方式建立 PDF 文件

  • 4.2：使用 HTML 文件以程式化方式建立 PDF 文件

  • 4.3：使用 URL 程式化建立 PDF 文件
• 4.4：以程式方式建立具格式的PDF文件
• 摘要

IronPDF

IronPDF 是一個供 .NET 開發人員使用的 C# PDF 程式庫，提供一組可用於以程式方式創建 PDF 檔案的類。 這些類別位於 IronPdf 程式集，並且設計為易於使用任何 .NET 語言，包括 C#、VB.NET、F# 等。該庫提供許多功能，用於創建 PDF 文件、操作現有 PDF 和讀取 PDF。

IronPDF 程式庫的當前版本支援以下功能：

• 加密、壓縮和未壓縮文件的讀取和寫入。
• 從頭開始創建新的 PDF 文件或通過解析現有文件流來創建。
• 在文件流中的頁面寫入磁碟作為新檔案之前，應用自訂轉換。
• 加密和解密 PDF 文件。
• 無縫合併現有的 PDF 文件。
• 建立和編輯互動式 PDF 表單。

• 有效地從頁面或文件中提取文字和許多其他獨特的功能。

  讓我們開始看看如何使用IronPDF庫在C#中以程式方式創建PDF。

以程式方式建立 PDF 檔案的步驟

本文將使用主控台應用程式模板進行此演示。 您可以根據您的需求和選擇來使用這些工具。您也可以使用現有的專案，然後在其中添加生成 PDF 文件的工具。

步驟 1：建立 C# 專案

本教程將使用 Visual Studio 和 C# 程式語言來建置我們的專案。 您應該具備HTML和C#語言的基本知識。 還建議您熟悉 Visual Studio。

我們將探討使用IronPDF C#庫以程式化方式創建PDF文件的多種方法。 讓我們開始建立一個 C# 專案。

• 打開 Visual Studio。
• 創建一個新的 C# 專案或打開一個現有的專案。
• 給專案取一個名字。

• 選擇 .Net Core >= 3.1，因為 3.1 受到支援且可在每個設備上運作。建議使用最新版本的 .Net Core。

  現在讓我們進入第 2 步。

步驟 2：安裝 IronPDF 函式庫

在進一步操作之前，我們應該在項目中安裝IronPdf庫。 我們可以以各種方式來做到這一點。

方法一：NuGet 套件管理員

我們可以從 NuGet 套件管理器安裝 IronPdf C# 庫。 開啟 NuGet 套件管理員，點擊 工具 > NuGet 套件管理員 > 管理 NuGet 套件方案。 這將打開 NuGet 套件管理器方案總管。

C# 程式化地創建 PDF 文件，圖 1：打開 NuGet 包管理器

開啟 NuGet 套件管理員

點擊瀏覽並在搜尋欄中輸入 IronPdf。 將顯示以下結果。 選擇IronPdf並點擊安裝按鈕； 程式庫將開始安裝。

搜尋並安裝 IronPdf 套件

方法 2：NuGet 套件管理器主控台

我們可以使用 NuGet 套件管理器控制台輕鬆安裝我們的庫。 安裝不需要任何管理權限。 您將使用 NuGet 命令在您的專案中安裝 IronPdf 庫。

Install-Package IronPdf

透過命令行安裝IronPdf套件

方法三：使用 DLL 檔案

在您的專案中使用IronPDF的第三種方法是從IronPDF庫中添加DLL檔案。 您可以下載 DLL 檔案。

• 下載 DLL 壓縮檔。將其解壓縮到特定的文件夾。

• 在 Visual Studio 中開啟專案。 在方案總管中，右鍵點擊「參考」，然後瀏覽 IronPDF DLL 檔案。

  造訪更詳細的安裝指南，以了解如何安裝IronPDF。

步驟 3：加入 IronPdf 命名空間

現在將 IronPdf 命名空間新增到您的程式中。 您必須在代碼的頂部添加給定的代碼行。

using IronPdf

這將使您能夠訪問 IronPDF 的功能。 您必須在每個希望使用IronPDF功能的文件中添加這行代碼。

步驟 4：以程式方式建立 PDF 文件

我們將探討由 IronPDF 提供的多種創建 PDF 的方法。 我們將看看使用簡單功能來創建 PDF 文件是多麼容易。 讓我們開始使用 HTML 字串創建 PDF。

4.1. 使用 HTML 字串以程式化方式建立 PDF

在 IronPDF 函式庫中，HTML 用於樣式設定目的。 您必須具備 HTML 語言的基本知識才能使用 IronPDF 庫生成 PDF 文件。

IronPDF 庫使處理 HTML 字串並將其轉換為 PDF 格式變得非常容易。 讓我們看看如何使用代碼來完成它。

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";

var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>"

Dim renderer = New ChromePdfRenderer()
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")

此程式碼將生成一個包含儲存在 htmlString 變數中的內容的 PDF 檔案。 在此程式碼範例中，已使用RenderHtmlAsPdf函數。 此功能將 HTML 字串轉換為 PDF 文件。

您必須熟悉HTML標籤以使用IronPDF庫生成PDF文件。 我們使用 SaveAs 函數來保存輸出 PDF 檔案。您可以在下方看到輸出的 PDF 檔案。

輸出：

PDF 文件輸出

4.2. 使用 HTML 文件以程式方式建立 PDF

IronPDF 庫提供了一個出色的功能，可以將 HTML 文件轉換為 PDF 文件。IronPDF 直接將 HTML 文件中的所有內容，包括圖像、CSS、表單等，轉換為 PDF 文檔。 它不需要任何其他庫或功能進行進一步處理。 IronPDF 可以直接將任何 HTML 文件轉換為 PDF 文件。

讓我們看看一些將 HTML 文件生成 PDF 文件的範例代碼：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")

我們使用RenderHtmlFileAsPdf 函數從 HTML 文件中創建 PDF。 此功能是給定程式碼範例中使用的最重要功能。 您可以在函數參數中提供 HTML 文件的位置，或者將 HTML 文件放在源代碼的 bin 資料夾中，這樣您只需在 RenderHtmlFileAsPdf 函數的參數中輸入帶有擴展名的文件名。 當您運行此程式碼時，輸出 PDF 檔案將會被保存到 bin 資料夾中。 SaveAs 函數將幫助您保存創建的 PDF 文件。

4.3. 使用URLs以程式化方式建立PDFs

有時候我們需要在程式中以編程方式創建一個 URL 的 PDF 檔案。 如果我們從頭開始編寫所有程式碼，這將是一項非常技術性的任務。 IronPDF 通過提供從 URL 創建 PDF 的優秀功能，幫助我們實現這一點。 您可以使用任何 URL 來創建 PDF。

讓我們來研究如何做到這一點：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")

上述程式碼將使用 RenderUrlAsPdf 函數生成給定 URL 參數的 PDF。 此功能會將URL製作成PDF。 如果從頭開始嘗試，這本來會是一項非常複雜的任務，因此IronPDF為開發人員提供了一個簡單的流程來將任何URL轉換為PDF。 SaveAs 函式用於將輸出文件保存到 bin 資料夾中。 若要將文件格式設置為 PDF，您必須在 SaveAs 函數中使用文件名參數指定 .pdf 擴展名。 您可以在專案資料夾中看到 bin 資料夾。 輸出顯示如下。

輸出：

從 URL 建立 PDF 檔案

4.4. 使用 ASP.NET Web Forms 以程式方式創建 PDF

ASP.NET 是一種伺服器端程式設計框架，能擴展 HTML 的功能並支援在瀏覽器中的網頁開發。 ASP.NET 頁面由 HTML、CSS 和 JavaScript 撰寫，可以被編寫為 ASPX 檔案（.aspx）。 ASP.NET Web Forms 創建使用者友好的多功能網站、網上銀行、內聯網和會計系統。

我們將使用IronPDF庫將ASP.NET Web表單轉換為PDF。 最初作為網頁呈現，我們將其轉換成 PDF，以便在網絡瀏覽器中查看和下載。 我們將使用IronPDF的AspxToPdf類來完成轉換。

讓我們看看如何做到這一點：

1. 在 Visual Studio 中建立一個 ASP.NET 網頁表單專案。 建議使用最新版本的 Visual Studio。

2. 使用 NuGet 套件管理器安裝 IronPDF 庫的 DLL 文件。您也可以使用 NuGet 套件管理器控制台來安裝它。

3. 現在，打開您想轉換為 PDF 文件的任何頂級網頁程式碼。在這裡，我們將為專案的預設 aspx 頁面建立 PDF。

   

   Visual Studio 中的 Web 表單專案結構

4. 打開 Default.aspx.cs 文件。將 IronPdf 命名空間添加到文件中，這是最重要的一行。

   using IronPdf;

5. 在 Page_Load 函數中撰寫以下程式碼行以建立頁面的 PDF 文件。

   AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

   就這樣！ 已創建Aspx網頁的PDF文件。 當您執行專案時，您將在瀏覽器中看到該網頁的 PDF。 結果與按 Ctrl+P 創建 PDF 時相同。在這裡，您不需要按 Ctrl+P 就可以為 aspx 文件創建 PDF。

   這是在伺服器端完成的。在此代碼中，我們使用了IronPDF的AspxToPdf類。 RenderThisPageAsPdf 函數創建 Aspx 網頁的 PDF。

   上述程式碼在瀏覽器中顯示 PDF 檔案。 我們可以在 Page_Load 函數中添加以下代碼行，直接在我們的系統中下載 PDF 文件：

   AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

   此程式碼將下載系統中 aspx 網頁的 PDF 檔案。 我們也可以設定 Aspx PDF 文件的名稱。有多種選項可用於修改和格式化，例如頁首、頁尾、列印選項、品質等。欲了解更多詳細資訊，請造訪這個全面的 Aspx 到 PDF 教學。

   輸出：

   

   從伺服器端渲染 PDF 文件的輸出

   探索適用於Blazor 應用程式創建 PDF 檔案的最新 Microsoft 技術

4.4. 程式化建立具有格式的 PDF 文件

在創建 PDF 時，大多數問題是在格式化 PDF 文件時遇到的。 以編程方式格式化PDF並不容易。 但是，我們現在有 IronPDF 這個解決方案。 IronPDF協助提供多種格式選項，讓我們可以自定義正在創建的PDF文件。 它為我們提供了添加頁首、頁尾、邊距及許多其他格式選項的方法。

使用 IronPDF 使我們能夠設定頁面方向、頁面大小和標題。 它還支持更改字體大小、字體顏色、字體類型和其他字體相關操作。 您可以添加帶有分隔線和自定義文本的頁腳和頁首。 讓我們看看如何使用 IronPDF 自訂 PDF 文件。

• 建立一個 C# 主控台專案。 您也可以根據需要創建一個 GUI 專案。 您也可以打開現有的專案。
• 使用 NuGet 套件管理器或 DLL 文件安裝 IronPDF 庫。

• 在程式碼檔案的頂部添加 IronPDF 命名空間。

  我們的應用程式設定已完成。 接下來，將以下代碼添加到 PDF 文件中：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;

//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  

Renderer.RenderingOptions.FirstPageNumber = 1; 

//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

Dim Renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
Renderer.RenderingOptions.PrintHtmlBackgrounds = True
Renderer.RenderingOptions.Title = "PDF Generated"
Renderer.RenderingOptions.Zoom = 100

'Margin Setting
Renderer.RenderingOptions.MarginTop = 40
Renderer.RenderingOptions.MarginLeft = 20
Renderer.RenderingOptions.MarginRight = 20
Renderer.RenderingOptions.MarginBottom = 40

Renderer.RenderingOptions.FirstPageNumber = 1

'Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = True
Renderer.RenderingOptions.TextHeader.CenterText = "Header!"
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

'Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = True
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
Renderer.RenderingOptions.TextFooter.FontSize = 10
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>"
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")

這段代碼正在格式化PDF文件。 RenderingOptions 是在創建 PDF 文件時設置不同屬性的主要工具。

• Renderer.RenderingOptions.TextHeader
• 這行程式碼用於設置 PDF 檔案的頁首。 您可以使用此程式碼行來訪問標頭的更多屬性。
• Renderer.RenderingOptions.TextFooter
• 這行程式碼設定了頁腳屬性，例如文字、頁腳的左右兩側、字體大小和其他許多屬性。
• Renderer.RenderingOptions.PaperOrientation
• 這行代碼允許用戶設置 PDF 文件的頁面方向。可以設置為橫向或縱向。

• Renderer.RenderingOptions.Title

  • 我們可以使用此行設置 PDF 文件的標題。

  在最後的幾行中，我們使用RenderHtmlAsPdf函數來建立一個HTML字串的PDF文件，但我們也可以使用HTML檔案無縫轉換為PDF，同時保留當前格式。 這是 IronPDF 的一個非常方便的功能，讓您完全自由地自定義與 PDF 文件相關的所有事物。

  輸出：

  

  具有格式支持的 PDF 輸出

摘要

本教程展示如何使用IronPDF C#庫以程式化方式創建PDF。 我們已經了解如何從 HTML 字串、HTML 文件、URL 和 ASP.NET 網頁表單創建 PDF 文件。 使用 IronPDF 函式庫，PDF 檔案的操作和格式化變得非常簡單。 只需要幾行程式碼即可以程式化方式創建和格式化 PDF 文件。 IronPDF 非常適合需要在其軟體中操作 PDF 文件的開發人員和公司使用。

您可以嘗試免費版本進行測試，並且有免費試用金鑰可用，無需任何信用卡付款。 此外，目前的特別優惠讓您以兩個的價格獲得五個IronPDF的產品。