如何使用 C# 在 ASP.NET 中將 HTML 轉換為 PDF

如何使用 IronPDF 在 ASP.NET 中將 HTML 轉換為 PDF

1. 使用 Visual Studio 或您選擇的 IDE 建立一個 ASP.NET 專案。
2. 安裝 IronPDF 並設定您的許可證金鑰。
3. 建立一個新的控制器或頁面，用於處理 PDF 轉換。
4. 在控制器中編寫轉換邏輯。
5. 設定路由以允許存取您的 PDF 產生操作。

IronPDF概述

IronPDF 是一個功能強大的 PDF 庫，可讓開發人員讀取、建立和操作 PDF 文件。 IronPDF 擁有豐富的功能集和快速簡單的安裝流程，可讓您立即將 PDF 專案提升到一個新的水平。 其直覺的 API 易於學習，如果您希望直接從您的 Web 應用程式產生動態 PDF 文件、執行 PDF 安全任務、PDF 註釋等，它將是理想的選擇。

先決條件

在開始之前，請確保您已準備好：

• 已安裝Visual Studio或其他 C# 開發環境。
• IronPDF庫已安裝。 您可以從 NuGet 取得，也可以直接從 IronPDF 網站取得。

建立一個新的 ASP.NET 項目

啟動 Visual Studio，然後選擇最符合您需求的 ASP.NET 專案類型。 今天的範例，我將建立一個 ASP.NET Core Web 應用程式（模型-視圖-控制器）。

如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF：圖 1

然後，輸入項目名稱並選擇項目存放位置。

如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF：圖 2

最後，為專案選擇 .NET Framework，並更改專案的任何其他設置，例如身份驗證類型，或啟用容器支援和 Docker。

如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF：圖 3

新增 HTML 轉 PDF 程式碼

現在我們已經建立了 ASP.NET 項目，可以開始編寫將 HTML 文件內容轉換為 PDF 的程式碼了。 我們將從一個簡單的 HTML 字串轉 PDF 的範例開始，然後再探討如何透過自訂轉換 HTML 內容。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF：圖 7

ASP.NET MVC使用控制器來處理使用者請求。 當使用者存取特定 URL 時，ASP.NET 將呼叫與該路由關聯的控制器中的方法。

• PdfController是一個繼承自 Controller 的類，這意味著它可以處理 Web 請求並發送回應。
• 此控制器中的GeneratePdf方法將處理將 HTML 轉換為 PDF 的請求並傳回結果。

當使用者存取與 GeneratePdf 操作關聯的 URL 時，該方法將執行。

• IActionResult：這是傳回類型，表示 Web 應用程式將向使用者發送的回應。 它可以是視圖（HTML頁面）、文件下載等等。在本例中，它是一個PDF檔案。

  • GeneratePdf() 方法：

  • 在該方法內部，我們定義了一個字串htmlContent ，其中包含要轉換為 PDF 的 HTML。 For example, "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>".

  • 我們建立了一個新的ChromePdfRenderer實例，用於處理 HTML 到 PDF 的轉換。

  • 方法RenderHtmlAsPdf()接受 HTML 字串並傳回 PDF 物件。

自訂 PDF 輸出

現在我們已經掌握了基本知識，接下來讓我們看看如何從 HTML 內容建立 PDF 文件，並為輸出 PDF 設定一些自訂設定。 IronPDF 提供了一套強大的 PDF 自訂工具，例如邊距、頁首/頁尾、自訂 PDF 尺寸等等。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF：圖 8

結論

今天我們仔細研究如何在 ASP.NET 中使用 HTML 到 PDF 的轉換，並探索了在 ASP.NET 專案中從 HTML 建立 PDF 文件的過程。 按照上述步驟，您可以輕鬆地將 PDF 生成功能整合到您的 Web 應用程式中，從而能夠從 HTML 內容創建高品質、可列印的文件。

IronPDF 擁有豐富的功能，可用於產生高品質的 PDF 文件。 有關更高級的功能和詳細的自訂設置，請參閱 IronPDF文件。 IronPDF安裝快捷，您可以立即在專案中設定好 IronPDF。