跳過到頁腳內容
使用IRONPDF

在ASP.NET Core中使用IronPDF創建PDF生成器

如果你是.NET開發人員,你可能已經遇到過在 Web 應用程式中從網頁產生 PDF 檔案的任務。 值得慶幸的是,在ASP.NET Core中,借助IronPDF PDF 庫,這個過程變得輕而易舉。 這樣,您只需一行程式碼即可快速產生 PDF 文件。 讓我們深入了解如何使用IronPDF建立 PDF 檔案。

本教程涵蓋的主題

本教學將涵蓋以下主題:

  • IronPDF
  • 建立一個ASP.NET Core Web 應用程式
  • 安裝IronPDF庫
    1. NuGet套件管理器
    2. NuGet套件管理器控制台
    3. 使用 DLL 文件 使用ASP.NET Core Web 應用程式建立 PDF 文檔
    4. 使用ASP.NET WebForms (ASPX) 建立 PDF 文檔
    5. 使用ASP.NET Core從 HTML 文件建立 PDF 文檔
  • 概括

IronPDF

IronPDF .NET程式庫讓開發人員可以使用 C#、F# 和 VB .NET為.NET Core和.NET Framework輕鬆建立 PDF 文件。 IronPDF 的渲染效果與 Google Chrome 桌面版完全一致,像素級還原。 它無需Adobe Acrobat即可處理PDF文件。 IronPDF可用於從ASP.NET網頁、HTML 內容、URL 或模型-視圖-控制器應用程式內部建立 PDF 檔案。

IronPDF .NET函式庫的一些重要功能:

-使用 HTML 、CSS 和JavaScript建立 PDF 文檔 -根據 URL 或網頁產生 PDF 文檔

我們先來看看如何使用IronPDF庫來建立 PDF 文件。

建立一個ASP.NET Core Web 應用程式

本教學假設您已安裝最新版本的 Visual Studio。

開啟 Visual Studio 建立一個新的ASP.NET Core Web 應用程式

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 1:Web 應用程式 Web應用程式

  • 為項目命名(例如Pdf_Generation
  • 最新且最穩定的.NET Framework版本是 6.0。請選擇此框架版本。

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 2: .NET Framework .NET Framework

安裝IronPDF庫

要建立 PDF 文檔,第一步是安裝IronPDF庫。 您可以使用以下任何一種方法進行安裝。

1. NuGet套件管理器

若要從NuGet套件管理器安裝IronPDF C# .NET Core庫:

  • 透過點選"工具" > "NuGet套件管理員" > "管理解決方案的NuGet套件"開啟 NuGet 套件管理員。

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 3: NuGet套件管理器 NuGet套件管理器

或者,在解決方案資源管理器中右鍵單擊項目,然後按一下"管理NuGet套件"

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 4: NuGet套件管理器 - 解決方案資源管理器 NuGet套件管理器 - 解決方案資源管理器

  • 搜尋IronPDF。 選擇IronPDF並點選安裝。 庫將開始安裝。

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 5: NuGet套件管理器 - 解決方案資源管理器 NuGet套件管理器 - 解決方案資源管理器

2. NuGet套件管理器控制台

點選"工具" > "NuGet套件管理器" > "套件管理器控制台"開啟NuGet套件管理員。 在終端機中輸入以下命令。

Install-Package IronPdf

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 6: NuGet套件管理器 - 解決方案資源管理器 NuGet套件管理器 - 解決方案資源管理器

3. 使用 DLL 文件

將IronPDF新增到專案中的第三種方法是從IronPDF庫中新增 DLL 檔案。 您可以從IronPDF軟體包的此直接下載頁面下載 DLL 檔案。

  • 下載 DLL zip 檔案並將其解壓縮到指定資料夾。
  • 在 Visual Studio 中開啟專案。 在解決方案資源管理器中,以滑鼠右鍵按一下"引用" ,然後導覽至IronPDF DLL 檔案。

在ASP.NET Core Web 應用程式中建立 PDF 文檔

IronPDF已經準備就緒,現在可以在ASP.NET Web Forms (ASPX) 和ASP.NET Core Web 應用程式中建立 PDF。

建立PDF文件的方法有很多種。 下面我們透過程式碼範例來看一下其中的一些範例。

1. 使用ASP.NET WebForms (ASPX) 建立 PDF

本節將示範如何從ASP.NET WebForms 產生 PDF 文件,但 ASP.NET WebForms 僅支援.NET Framework版本 4。因此,需要從 ASPX 的官方NuGet頁面安裝IronPDF 。 由於 ASPX 已被 MVC 模型取代,因此它在.NET Core中不可用。

開啟要轉換為 PDF 文件的 ASPX 網頁的來源文件,在本例中,建立一個新的 Default.aspx 頁面。

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 7: NuGet套件管理器 - 解決方案資源管理器 NuGet套件管理器 - 解決方案資源管理器

開啟 Default.aspx.cs 文件,並在其頂部新增IronPDF命名空間。

using IronPdf;
using IronPdf;
$vbLabelText   $csharpLabel

接下來,在 Page_Load() 函數中寫入以下程式碼行:

// This code renders the current ASPX page as a PDF file and displays it in the browser.
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
// This code renders the current ASPX page as a PDF file and displays it in the browser.
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
$vbLabelText   $csharpLabel

只需一行程式碼,即可從ASP.NET網頁建立一個新的 PDF 文件。

RenderThisPageAsPdf方法在AspxToPdf類別中使用,用於將 ASPX 頁面轉換為 PDF 檔案。

運行專案後,網頁的 PDF 檔案將出現在瀏覽器中。 這是在伺服器端完成的。

上述程式碼僅在瀏覽器中顯示 PDF 文件。 也可以透過在 Page_Load() 函數中新增以下程式碼行,將 PDF 文件直接下載到電腦上:

// This code downloads the generated PDF file of the current ASPX page to the client.
AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);
// This code downloads the generated PDF file of the current ASPX page to the client.
AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);
$vbLabelText   $csharpLabel

這段程式碼會將 ASPX 網頁的 PDF 檔案下載到.NET專案目錄中。

輸出:

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 8:ASPX 頁面轉 PDF ASPX 頁面轉 PDF

2. 使用ASP.NET Core從 HTML 檔案建立 PDF

本節將示範如何在ASP.NET Core中產生 PDF 檔案。 IronPDF可以將 HTML 文件中的所有內容(包括圖像、CSS、表單等)直接轉換為 PDF 文件。 新增一個按鈕,點擊後即可產生 PDF 檔案。

將以下標記新增至您選擇的任何 .cshtml 頁面(此處將使用 index.cshtml)。

<div>
    <form method="post" asp-page="Index" asp-page-handler="GeneratePDF">
        <input type="Submit" value="GeneratePDF"/>
    </form>
</div>
<div>
    <form method="post" asp-page="Index" asp-page-handler="GeneratePDF">
        <input type="Submit" value="GeneratePDF"/>
    </form>
</div>
HTML

index.cshtml.cs 檔案中,建立一個名為 OnPostGeneratePDF 的方法。 此函數將用於把 HTML 渲染成 PDF。

public void OnPostGeneratePDF()
{
    // Placeholder method that will handle PDF generation.
}
public void OnPostGeneratePDF()
{
    // Placeholder method that will handle PDF generation.
}
$vbLabelText   $csharpLabel

接下來,為您的 Web 應用程式新增一個新的 HTML 頁面。

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 9:新增網頁 新增網頁

在本頁正文中加入一些文字,例如:"從 HTML 頁面產生 PDF 檔案"。

最後,在 OnPostGeneratePDF 操作方法中加入以下程式碼。

public void OnPostGeneratePDF()
{
    // Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
    var renderer = new ChromePdfRenderer();

    // Render the HTML file as a PDF by specifying the path and save the resulting PDF file.
    var pdf = renderer.RenderHtmlFileAsPdf("Pages/htmlpage.html");

    // Save the generated PDF document with the specified name.
    pdf.SaveAs("MyPdf.pdf");
}
public void OnPostGeneratePDF()
{
    // Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
    var renderer = new ChromePdfRenderer();

    // Render the HTML file as a PDF by specifying the path and save the resulting PDF file.
    var pdf = renderer.RenderHtmlFileAsPdf("Pages/htmlpage.html");

    // Save the generated PDF document with the specified name.
    pdf.SaveAs("MyPdf.pdf");
}
$vbLabelText   $csharpLabel

在上面, RenderHtmlFileAsPdf函數用於透過指定要轉換的 HTML 檔案的路徑,從 HTML 檔案建立 PDF。

運行專案並點擊"生成 PDF"按鈕。 產生的 PDF 檔案將會出現在ASP.NET Core專案資料夾中。

輸出:

使用IronPDF在ASP.NET中建立 PDF 產生器,圖 10: ASP.NET HTML 頁轉 PDF ASP.NET HTML 頁面轉 PDF

造訪教學頁面,了解如何在ASP.NET Core中將 MVC 視圖轉換為 PDF

概括

IronPDF .NET Core是一個用於處理 PDF 文件的完整解決方案。 它能夠將不同格式的文件轉換為新的 PDF 文件。 只需幾行程式碼即可透過程式設計方式建立和格式化 PDF 檔案。

IronPDF的主要亮點是 HTML 轉換器,它在背景使用符合標準的真實 Web 瀏覽器實例來渲染 HTML 文件。 HTML 以向量格式精確渲染,符合商業印刷的最高標準。 輸出結果為清晰、高品質的PDF檔案。

IronPDF非常適合需要在軟體中處理 PDF 文件的開發人員和公司。 商業許可和定價詳情已在網站上公佈。

您可以試試IronPDF庫的免費版本來測試其功能。 免費試用許可證金鑰可讓您測試 IronPDF 的全部功能。

此外,還有一項特別優惠,您可以以兩款產品的價格獲得全部五款Iron Software產品。 有關許可的更多信息,請訪問Iron Software許可資訊頁面

常見問題解答

如何在不丟失格式的情況下在 ASP.NET Core 中生成 PDF 文檔?

您可以使用 IronPDF 從 HTML 內容、CSS 和 JavaScript 創建高質量、像素完美的 PDF 。IronPDF 的渲染引擎基於 Google Chrome,確保格式保持。

在 ASP.NET Core 中從 HTML 創建 PDF 的最簡單方法是使用 IronPDF 的RenderHtmlAsPdf 方法,這可以輕鬆地將 HTML 字符串轉換為 PDF 文檔。

在ASP.NET Core中,從HTML創建PDF的最簡單方法是使用IronPDF的RenderHtmlAsPdf方法,輕鬆將HTML字符串轉換為PDF文檔。

是的,IronPDF 允許您在 ASP.NET Core 中將網頁轉換為 PDF,它通過使用ChromePdfRenderer類將網頁的 HTML 內容渲染為 PDF 文檔。

是的,IronPDF 允許您通過使用 ChromePdfRenderer 類來將網頁的 HTML 內容呈現為 PDF 文件,將網頁轉換為 PDF。

是的,除了使用 NuGet 包管理器之外,您還可以直接將 IronPDF DLL 文件添加到項目中,以便在您的 ASP.NET Core 應用程序中安裝該庫。

如何確保我的 ASP.NET Core 應用程序支持從 URL 生成 PDF?

使用 IronPDF,您可以通過使用其將網頁渲染為 PDF 的功能,從 URL 生成 PDF,輕鬆將任何可訪問的 URL 轉換為 PDF 文檔。

在 ASP.NET Core 中使用 PDF 庫的優勢是什麼?

在 ASP.NET Core 中使用 IronPDF 提供了多種優勢,包括能夠從各種類型的內容生成 PDF ,提取文本和圖像,執行數字簽名,並通過可靠的渲染引擎保持格式。

如何在 ASP.NET Core 中生成 PDF 時添加網路憑證?

在 ASP.NET Core 中生成 PDF 時,如何添加網路憑證?

IronPDF 允許您在 PDF 生成過程中添加自訂網路憑證,確保在 ASP.NET Core 應用程序中創建 PDF 時對受保護資源的訪問。

我可以在不購買的情況下測試一個庫的 PDF 生成能力嗎?

是的,您可以使用 IronPDF 的免費試用版本來測試其完整功能,這允許您在購買之前評估其 PDF 生成能力。

是否可以在 ASP.NET Core 之後使用 ASP.NET WebForms 的 PDF 庫?

是的,IronPDF 向後兼容 ASPX,允許您在 ASP.NET WebForms 和 ASP.NET Core 應用中進行 PDF 生成。

IronPDF 是否與 .NET 10 相容?

是的。 IronPDF 完全相容於 .NET 10,以及 .NET 8 和 .NET 9。它支援所有主流專案類型(網路、桌面、控制台和雲端),無需任何變通或調整。隨著 .NET 新技術的不斷湧現,IronPDF 始終保持面向未來的兼容性。 (請參閱 IronPDF 對 .NET 10 的跨平台支援)

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me