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

如何在 ASP.NET Core 中快速將 HTML 轉換為 PDF？

在 ASP.NET Core 中開始進行 HTML 到 PDF 的轉換只需要幾行程式碼。 首先，安裝 IronPDF NuGet 套件管理器控制台套件：

Install-Package IronPdf

那麼，你想學習如何在 ASP.NET 中使用 C# 將 HTML 轉換為 PDF 嗎？ 以下是一個完整的程式碼片段，示範如何在 ASP.NET Core MVC 控制器中將 HTML 字串轉換為 PDF 文件，以幫助您入門：

using IronPdf;
using Microsoft.AspNetCore.Mvc;
// your program.cs file
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
var app = builder.Build();
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
app.Run();
// in your controller file
public class PdfController : Controller
{
    public IActionResult GeneratePdf()
    {
        var renderer = new ChromePdfRenderer();
        // Convert HTML string to PDF
        string HTML = @"
            <h1>Invoice #2024-001</h1>
            <p>Generated on: " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
            <table>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Professional License</td><td>$799</td></tr>
            </table>";
        var PDF = renderer.RenderHtmlAsPdf(html);
        // Return PDF as file download
        return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;
// your program.cs file
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
var app = builder.Build();
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");
app.Run();
// in your controller file
public class PdfController : Controller
{
    public IActionResult GeneratePdf()
    {
        var renderer = new ChromePdfRenderer();
        // Convert HTML string to PDF
        string HTML = @"
            <h1>Invoice #2024-001</h1>
            <p>Generated on: " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
            <table>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Professional License</td><td>$799</td></tr>
            </table>";
        var PDF = renderer.RenderHtmlAsPdf(html);
        // Return PDF as file download
        return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

針對不同HTML來源文件，有哪些基本方法？

IronPDF 提供了三種將 HTML 內容轉換為 PDF 格式的主要方法，每種方法都針對您在 ASP.NET 開發中會遇到的特定場景而設計。

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
pdf.SaveAs("webpage.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

如何處理表單資料和 POST 請求？

在 ASP.NET 應用程式中，在產生 PDF 之前對表單資料進行處理是一種常見的做法。 以下是如何處理 POST 方法提交並從提交的資料產生 PDF 的方法：

[HttpPost]
public IActionResult ProcessFormToPdf(OrderModel model)
{
    var renderer = new ChromePdfRenderer();
    // Build HTML from form data
    string HTML = $@"
        <h2>Order Confirmation</h2>
        <p>Customer: {model.CustomerName}</p>
        <p>Order Date: {model.OrderDate:yyyy-MM-dd}</p>
        <ul>
            {string.Join("", model.Items.Select(i => $"<li>{i.Name} - ${i.Price}</li>"))}
        </ul>
        <p><strong>Total: ${model.Total}</strong></p>";
    var PDF = renderer.RenderHtmlAsPdf(html);
    // Save to server and return download
    var fileName = $"order-{model.OrderId}.pdf";
    return File(pdf.BinaryData, "application/pdf", fileName);
}

[HttpPost]
public IActionResult ProcessFormToPdf(OrderModel model)
{
    var renderer = new ChromePdfRenderer();
    // Build HTML from form data
    string HTML = $@"
        <h2>Order Confirmation</h2>
        <p>Customer: {model.CustomerName}</p>
        <p>Order Date: {model.OrderDate:yyyy-MM-dd}</p>
        <ul>
            {string.Join("", model.Items.Select(i => $"<li>{i.Name} - ${i.Price}</li>"))}
        </ul>
        <p><strong>Total: ${model.Total}</strong></p>";
    var PDF = renderer.RenderHtmlAsPdf(html);
    // Save to server and return download
    var fileName = $"order-{model.OrderId}.pdf";
    return File(pdf.BinaryData, "application/pdf", fileName);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

哪些進階功能可以增強 PDF 生成？

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

為什麼選擇 IronPDF 進行 ASP.NET PDF 產生？

IronPDF 以 Chrome 為基礎的渲染引擎可確保將 HTML 精確轉換為 PDF，並完全支援現代 Web 標準。 該程式庫能夠處理其他 PDF 轉換器難以處理的複雜 JavaScript、CSS3 動畫和響應式佈局。 整合只需要幾行程式碼，非常適合在 .NET 專案或 .NET 應用程式中進行快速開發。

ChromePdfRenderer 類別透過其 RenderingOptions 屬性提供廣泛的自訂功能，可讓您控制紙張大小、邊距、JavaScript 執行和渲染延遲。 這種靈活性確保您的 PDF 輸出符合精確的規範，無論是產生簡單的發票還是複雜的多頁報告。

該庫甚至可以以相同的保真度渲染整個網頁或較小的 HTML 片段，而不會留下任何臨時檔案。 這一切使其成為您HTML轉PDF轉換器的強大選擇。

結論

使用 IronPDF 在 ASP.NET C# 中將 HTML 轉換為 PDF，可以簡化文件產生工作流程，同時保持完美的視覺保真度。 該庫的簡單 API 和強大的渲染功能使其成為任何需要生成 PDF 的 ASP.NET Core 應用程式的理想解決方案。 無論您是為 .NET Core、.NET Framework 開發，還是建立行動應用程序，它都是完成此任務的完美 .NET 封裝器。

您也可以透過命令列或直接在 Visual Studio 中使用解決方案資源管理器來使用它。 您經常會在類似 static async Task Main 的方法中使用類似 var client（或 var renderer）和字串 url（或檔案名稱）的模式，以便直接從輸入的 HTML 或 url 以程式設計方式儲存 PDF。

立即開始免費試用，將您的 HTML 程式碼轉換為專業的 PDF 文件。 對於生產環境部署，請探索我們的授權選項，找到最適合您專案需求的方案。