C#程式化創建PDF文件

在繼續進行之前，我們應該在專案中安裝 IronPdf 庫。 我們可以透過多種方式來實現這一點。

方法一： NuGet套件管理器

我們可以從NuGet套件管理器安裝 IronPdf C# 函式庫。 點選"工具"> "NuGet套件管理員">"管理解決方案的NuGet套件"，開啟 NuGet 套件管理員。 這將開啟NuGet套件管理器解決方案資源管理器。

開啟NuGet套件管理器

點擊"瀏覽"，然後在搜尋欄中輸入IronPDF 。 將顯示以下結果。 選擇IronPDF並點擊"安裝"按鈕； 庫將開始安裝。

搜尋並安裝IronPDF軟體包

方法二： NuGet套件管理器控制台

我們可以使用NuGet套件管理器控制台快速安裝我們的庫。 安裝此軟體不需要任何管理員權限。 您可以使用NuGet命令在您的專案中安裝 IronPdf 庫。

Install-Package IronPdf

透過命令列安裝IronPDF軟體包

方法三：使用 DLL 文件

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

• 下載 DLL 壓縮檔。將其解壓縮到指定資料夾。
• 在 Visual Studio 中開啟一個專案。 在解決方案資源管理器中，右鍵單擊"引用"，然後瀏覽並找到IronPDF DLL 檔案。

請造訪更詳細的IronPDF安裝指南。

我們將探討使用IronPDF建立 PDF 的多種方法。 我們將看到使用簡單函數建立 PDF 文件是多麼容易。 讓我們開始使用 HTML 字串建立 PDF 吧。

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

IronPDF庫使用 HTML 來實現樣式設定。 要使用IronPDF庫產生 PDF 文檔，您必須具備 HTML 語言的基礎知識。

IronPDF庫可以非常輕鬆地處理 HTML 字串並將其轉換為 PDF 格式。 讓我們來看看如何用程式碼來實現。

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

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

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

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

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

這段程式碼將產生一個 PDF 文件，其中包含儲存在 htmlString 變數中的內容。 在這個程式碼範例中，使用了RenderHtmlAsPdf函數。 此函數將 HTML 字串轉換為 PDF 文件。

若要使用IronPDF庫產生 PDF 文件，您必須熟悉 HTML 標籤。 SaveAs 函數用於保存輸出的 PDF 檔案。您可以在下方看到輸出的 PDF 檔案。

輸出：

PDF 檔案輸出

4.2. 使用 HTML 檔案以程式設計方式建立 PDF

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

讓我們來看一段從 HTML 檔案建立 PDF 檔案的範例程式碼：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

我們使用RenderHtmlFileAsPdf函數從 HTML 檔案建立 PDF。 您可以將 HTML 檔案位置放在函數參數中，或將 HTML 檔案放在原始程式碼的 bin 資料夾中，這樣您只需將帶有副檔名的檔案名稱放在 RenderHtmlFileAsPdf 函數的參數中即可。 運行此程式碼後，輸出的 PDF 檔案將保存在 bin 資料夾中。 SaveAs 函數用於保存已建立的 PDF 檔案。

4.3. 使用 URL 以程式設計方式建立 PDF

有時我們需要在程式中以程式設計方式建立 URL 的 PDF 檔案。 如果所有程式碼都從零開始編寫，這將是一項技術性很強的任務。 IronPDF在這裡幫了我們很大的忙，它提供了一個非常棒的功能，可以從 URL 建立 PDF 檔案。 您可以使用任何URL建立PDF文件。

讓我們來看看具體該怎麼做：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
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";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var 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 的功能，並支援在瀏覽器中進行 Web 開發。 ASP.NET頁面是用 HTML、CSS 和JavaScript編寫的，可以編碼為 ASPX 檔案 (.aspx)。 ASP.NET Web 表單可建立使用者友善、功能豐富的網站、網路銀行、企業內部網路和會計系統。

我們將使用IronPDF庫將ASP.NET Web 表單轉換為 PDF。 最初會以網頁形式呈現，我們將把它轉換成 PDF 文件，以便在網頁瀏覽器中查看和下載。 我們將使用IronPDF的 AspxToPdf 類別來完成轉換。

我們來看看具體該怎麼做：

1. 在 Visual Studio 中建立一個ASP.NET Web 表單專案。 建議使用最新版本的 Visual Studio。
2. 根據您的選擇，使用NuGet套件管理器或 DLL 檔案安裝IronPDF庫。您也可以使用NuGet套件管理器控制台進行安裝。
3. 現在，開啟任何你想轉換成 PDF 檔案的 ASPX 網頁程式碼。這裡我們將建立專案中 Default.aspx 頁面的 PDF 檔案。

Visual Studio 中的 Web 表單專案結構

4. 開啟 Default.aspx.cs 文件。將 IronPdf 命名空間新增至該檔案中，這是最重要的一行。

using IronPdf;

using IronPdf;

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

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

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

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

這段程式碼會將系統中的 ASPX 網頁的 PDF 檔案下載下來。 我們也可以設定 ASPX PDF 檔案的名稱。此外，還有多種修改和格式設定選項可供使用，例如頁首、頁尾、列印選項、品質等等。更多詳情，請造訪這篇全面的 ASPX 轉 PDF 教學。

輸出：

伺服器端渲染 PDF 檔案的輸出

探索用於Blazor應用程式的最新 Microsoft 技術，以建立 PDF 文件

4.5. 透過程式設計方式建立帶有格式的 PDF

建立 PDF 時，大多數問題都發生在 PDF 文件的格式化過程中。 透過程式方式格式化 PDF 文件並不容易。 但是，我們現在有了像IronPDF這樣的解決方案。 IronPDF提供各種格式選項，使我們能夠自訂正在建立的 PDF 檔案。 它為我們提供了添加頁眉、頁腳、頁邊距和許多其他格式選項的方法。

使用IronPDF可以設定頁面方向、頁面大小和標題。 它還支援更改字體大小、字體顏色、字體類型以及其他與字體相關的操作。 您可以新增帶有分隔線和自訂文字的頁首和頁尾。 讓我們來看看如何使用IronPDF自訂 PDF 檔案。

• 建立一個 C# 控制台專案。 您也可以根據需要建立 GUI 專案。 您也可以開啟現有項目。
• 使用NuGet套件管理器或 DLL 檔案安裝IronPDF庫。
• 在程式碼檔案頂部新增IronPDF命名空間。

應用程式的設定現已完成。 接下來，將以下程式碼新增至 PDF 檔案：

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
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 Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

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

// Footer Settings
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}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
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 Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

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

// Footer Settings
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}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
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 輸出