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

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

1. 使用Visual Studio或您選擇的IDE創建ASP.NET專案。
2. 安裝IronPDF並設置您的授權金鑰。
3. 創建一個新控制器或頁面來處理PDF轉換。
4. 在控制器內編寫轉換邏輯。
5. 配置路由以允許訪問您的PDF生成動作。

IronPDF概述

IronPDF是一個強大的PDF程式庫，允許開發者讀取、創建和操作PDF文件。 憑藉豐富的功能集和快速、簡單的安裝過程，您可以輕鬆地將您的PDF專案提升到更高的水平。 其直觀的API易於學習，若您希望直接從網路應用生成動態PDF文件、執行PDF安全任務、PDF註釋等，它是理想選擇。

先決條件

在開始之前，確保您擁有：

• Visual Studio或其他C#開發環境。
• 已安裝的IronPDF程式庫。 您可以從NuGet或直接從IronPDF網站獲得它。

創建新的ASP.NET專案

啟動Visual Studio並選擇最適合您需求的ASP.NET專案類型。 今天的例子中，我將創建一個ASP.NET Core網頁應用程式（模型-視圖-控制器）。

然後，輸入專案的名稱並選擇儲存專案的位置。

最後，為專案選擇.NET Framework，並更改專案的一些額外設置，如身份驗證類型，或啟用容器支援及docker。

添加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 MVC使用控制器來處理用戶請求。 當用戶導航到特定URL時，ASP.NET將調用與該路由關聯的控制器中的一個方法。

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

當用戶訪問鏈接到GeneratePdf動作的URL時，該方法將執行。

• IActionResult： 這是返回類型，代表網路應用程式將發送回用戶的回應。 它可以是視圖（HTML頁面）、文件下載等。在這種情況下，它是一個PDF文件。

  • GeneratePdf() 方法：

  • 在該方法內，我們定義了一個包含您希望轉換為PDF的HTML內容的字符串htmlContent。 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中使用HTML到PDF轉換，並探討了在ASP.NET專案中從HTML創建PDF文件的過程。 通過遵循上述步驟，您可以輕鬆地將PDF生成整合到您的網路應用中，使您能夠從HTML內容創建高質量的可打印文件。

IronPDF擁有豐富的功能集，可以用於生成高質量的PDF文件。 如需更高級的功能和詳細的自訂，請參考IronPDF文件。 憑藉其快速的安裝，您可以在不久的將來將IronPDF設置在您的專案中。