使用IRONPDF

ASP.NET Core 中的动态 PDF 生成：即时创建 PDF

已更新:十一月 25, 2025

在 ASP.NET Core 中构建现代 Web 应用程序时，动态生成 PDF 文档的功能至关重要。无论你是创建发票、报告还是证书，用户都希望能够立即生成 PDF 文件，而无需服务器端存储。 IronPDF强大的 PDF 库让您可以轻松地在 .NET Core 项目中即时创建 PDF。

在本文中，我们将引导您完成在 ASP.NET 应用程序中轻松即时创建 PDF 文档所需的步骤。

即时创建 PDF 是什么意思？

即时创建 PDF 指的是在内存中动态生成 PDF 文档，并将其直接传输到用户的浏览器。此服务器端处理过程消除了将 PDF 文件保存到磁盘的需要，从而提高了性能和安全性。通过 IronPDF 的 SDK，您可以将 HTML 内容瞬间转换为专业的 PDF 文档，非常适合需要在不在服务器上存储文件的情况下创建 PDF 的Web 应用程序。

立即开始使用 IronPDF。

如何设置 IronPDF 以生成动态 PDF 文件？

首先，通过 NuGet 包管理器安装 IronPDF，将这个强大的 PDF 库添加到您的 ASP.NET Core 项目中：

Install-Package IronPdf

接下来，在 ASP.NET Core 应用程序中配置 IronPDF，以动态创建 PDF 文件：

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PdfGenerator.Controllers
{
    public class DocumentController : Controller
    {
        private readonly ChromePdfRenderer _renderer;

        public DocumentController()
        {
            // Initialize the renderer once for reuse
            _renderer = new ChromePdfRenderer();
            // Optional: Set your license key
            License.LicenseKey = "YOUR-LICENSE-KEY";
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PdfGenerator.Controllers
{
    public class DocumentController : Controller
    {
        private readonly ChromePdfRenderer _renderer;

        public DocumentController()
        {
            // Initialize the renderer once for reuse
            _renderer = new ChromePdfRenderer();
            // Optional: Set your license key
            License.LicenseKey = "YOUR-LICENSE-KEY";
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

此设置初始化ChromePdfRenderer ，这是 IronPDF 的强大渲染引擎，它使用 Chromium 将 HTML 转换为 PDF 文档。通过创建单个渲染器实例，可以优化重复创建 PDF 时的内存使用情况。了解更多关于HTML转PDF转换的高级技巧。

如何从HTML内容创建PDF文档？

创建 PDF 文件的核心功能是将 HTML 字符串转换为 PDF 文档。以下是一个详细示例，展示如何快速生成发票：

[HttpGet]
public IActionResult GenerateInvoice(int orderId)
{
    // Fetch data from your database or service
    var orderData = GetOrderData(orderId);
    // Build HTML content with dynamic data
    string htmlContent = $@"
        <!DOCTYPE html>
        <html>
        <head>
            <style>
                body {{ font-family: Arial, sans-serif; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                table {{ width: 100%; border-collapse: collapse; }}
                td, th {{ padding: 10px; border: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{orderData.InvoiceNumber}</h1>
                <p>Date: {DateTime.Now:yyyy-MM-dd}</p>
            </div>
            <table>
                <tr>
                    <th>Item</th>
                    <th>Quantity</th>
                    <th>Price</th>
                </tr>";
    foreach(var item in orderData.Items)
    {
        htmlContent += $@"
                <tr>
                    <td>{item.Name}</td>
                    <td>{item.Quantity}</td>
                    <td>${item.Price:F2}</td>
                </tr>";
    }
    htmlContent += @"
            </table>
        </body>
        </html>";
    // Create PDF from HTML
    var pdf = _renderer.RenderHtmlAsPdf(htmlContent);
    // Convert to byte array for streaming
    byte[] pdfBytes = pdf.BinaryData;
    // Return PDF to browser
    return File(pdfBytes, "application/pdf", $"invoice_{orderId}.pdf");
}

[HttpGet]
public IActionResult GenerateInvoice(int orderId)
{
    // Fetch data from your database or service
    var orderData = GetOrderData(orderId);
    // Build HTML content with dynamic data
    string htmlContent = $@"
        <!DOCTYPE html>
        <html>
        <head>
            <style>
                body {{ font-family: Arial, sans-serif; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                table {{ width: 100%; border-collapse: collapse; }}
                td, th {{ padding: 10px; border: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{orderData.InvoiceNumber}</h1>
                <p>Date: {DateTime.Now:yyyy-MM-dd}</p>
            </div>
            <table>
                <tr>
                    <th>Item</th>
                    <th>Quantity</th>
                    <th>Price</th>
                </tr>";
    foreach(var item in orderData.Items)
    {
        htmlContent += $@"
                <tr>
                    <td>{item.Name}</td>
                    <td>{item.Quantity}</td>
                    <td>${item.Price:F2}</td>
                </tr>";
    }
    htmlContent += @"
            </table>
        </body>
        </html>";
    // Create PDF from HTML
    var pdf = _renderer.RenderHtmlAsPdf(htmlContent);
    // Convert to byte array for streaming
    byte[] pdfBytes = pdf.BinaryData;
    // Return PDF to browser
    return File(pdfBytes, "application/pdf", $"invoice_{orderId}.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

这段代码演示了如何通过将 HTML 页面模板与实时数据相结合来生成动态 PDF 文件。 RenderHtmlAsPdf 方法处理 HTML 内容（包括 CSS 样式），并生成可供下载的专业文档。该方法支持复杂的布局、图像，甚至支持 JavaScript 执行。您可以在新标签页中查看输出结果。

示例输出

! ASP.NET 程序动态生成 PDF：.NET Core 中的动态 PDF 生成：图 1 - 使用我们的 ASP.NET 程序动态生成的 PDF 示例

如何将 PDF 文件直接流式传输给用户而不保存到磁盘？

实时传输 PDF 需要处理内存流和字节数组。这种方法确保 PDF 文档永远不会访问服务器的文件系统，这对于云部署和容器化应用程序至关重要：

[HttpPost]
public async Task<IActionResult> CreateReport([FromBody] ReportRequest request)
{
    // Generate HTML from request data
    string html = BuildReportHtml(request);
    // Create PDF in memory
    var pdfDocument = _renderer.RenderHtmlAsPdf(html);
    // Use MemoryStream for efficient streaming
    using (var memoryStream = new MemoryStream())
    {
        // Write PDF binary data to the memory stream
        memoryStream.Write(pdfDocument.BinaryData, 0, pdfDocument.BinaryData.Length);
        // Set response headers for inline display
        Response.Headers.Add("Content-Disposition", "inline; filename=report.pdf");
        // Return FileContentResult with proper content type
        return new FileContentResult(memoryStream.ToArray(), "application/pdf");
    }
}

[HttpPost]
public async Task<IActionResult> CreateReport([FromBody] ReportRequest request)
{
    // Generate HTML from request data
    string html = BuildReportHtml(request);
    // Create PDF in memory
    var pdfDocument = _renderer.RenderHtmlAsPdf(html);
    // Use MemoryStream for efficient streaming
    using (var memoryStream = new MemoryStream())
    {
        // Write PDF binary data to the memory stream
        memoryStream.Write(pdfDocument.BinaryData, 0, pdfDocument.BinaryData.Length);
        // Set response headers for inline display
        Response.Headers.Add("Content-Disposition", "inline; filename=report.pdf");
        // Return FileContentResult with proper content type
        return new FileContentResult(memoryStream.ToArray(), "application/pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

示例输出 PDF 文档

! ASP 即时创建 PDF：.NET Core 中的动态 PDF 生成：图 2 - 使用字节数组和流创建的 PDF

字节数组方法允许您完全在内存中创建 PDF。内容类型"application/pdf"告诉浏览器如何处理该文件，而 Content-Disposition 标头决定 PDF 文件是在浏览器中打开还是触发下载。有关PDF 到 MemoryStream 转换的更多详细信息，请查看我们的文档。当用户按下按钮发送请求时，服务器将运行此代码以继续该过程。

立即开始免费试用，体验动态 PDF 生成功能！

如何从动态数据库内容生成PDF？

实际应用中，ASP.NET Core 应用程序经常需要根据数据库查询结果创建 PDF 报告。以下是如何使用 Entity Framework Core 数据生成 PDF 文件并进行正确错误处理的方法：

[HttpGet("report/monthly")]
public async Task<IActionResult> MonthlyReport(int year, int month)
{
    // Query database for report data
    var reportData = await _context.Transactions
        .Where(t => t.Date.Year == year && t.Date.Month == month)
        .GroupBy(t => t.Category)
        .Select(g => new {
            Category = g.Key,
            Total = g.Sum(t => t.Amount),
            Count = g.Count()
        })
        .ToListAsync();
    // Build HTML template with style
    var htmlTemplate = @"<h2>Monthly Report</h2>
                         <table style='width:100%'>";
    foreach(var item in reportData)
    {
        htmlTemplate += $"<tr><td>{item.Category}</td>" +
                       $"<td>{item.Count} items</td>" +
                       $"<td>${item.Total:F2}</td></tr>";
    }
    htmlTemplate += "</table>";
    // Generate PDF document with settings
    var pdf = _renderer.RenderHtmlAsPdf(htmlTemplate);
    // Add metadata to PDF
    pdf.MetaData.Title = $"Report {month}/{year}";
    pdf.MetaData.Author = "Reporting System";
    // Stream PDF to user
    return File(pdf.BinaryData, "application/pdf");
}

[HttpGet("report/monthly")]
public async Task<IActionResult> MonthlyReport(int year, int month)
{
    // Query database for report data
    var reportData = await _context.Transactions
        .Where(t => t.Date.Year == year && t.Date.Month == month)
        .GroupBy(t => t.Category)
        .Select(g => new {
            Category = g.Key,
            Total = g.Sum(t => t.Amount),
            Count = g.Count()
        })
        .ToListAsync();
    // Build HTML template with style
    var htmlTemplate = @"<h2>Monthly Report</h2>
                         <table style='width:100%'>";
    foreach(var item in reportData)
    {
        htmlTemplate += $"<tr><td>{item.Category}</td>" +
                       $"<td>{item.Count} items</td>" +
                       $"<td>${item.Total:F2}</td></tr>";
    }
    htmlTemplate += "</table>";
    // Generate PDF document with settings
    var pdf = _renderer.RenderHtmlAsPdf(htmlTemplate);
    // Add metadata to PDF
    pdf.MetaData.Title = $"Report {month}/{year}";
    pdf.MetaData.Author = "Reporting System";
    // Stream PDF to user
    return File(pdf.BinaryData, "application/pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

这种模式允许您从任何数据源创建 PDF，立即将数据库记录转换为格式化文档。 HTML模板方法使得维护和修改报表布局变得容易。对于更复杂的情况，您还可以探索如何从现有文档创建 PDF，并找到指向更多信息索引的链接。我们希望这能成为一个好例子。

即时生成 PDF 的最佳实践是什么？

在 ASP.NET Core 中动态创建 PDF 文件时，请考虑以下优化策略：

异步操作：生成多个 PDF 文件时，使用异步方法可以防止阻塞服务器线程池：

var pdfTask = _renderer.RenderHtmlAsPdfAsync(htmlContent);
var pdf = await pdfTask;

var pdfTask = _renderer.RenderHtmlAsPdfAsync(htmlContent);
var pdf = await pdfTask;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

内存管理：对于大型 PDF 文件，应妥善释放资源，并考虑直接将数据流式传输到响应中，以最大限度地减少内存使用量：

using (var pdf = _renderer.RenderHtmlAsPdf(html))
{
    return File(pdf.Stream, "application/pdf");
}

using (var pdf = _renderer.RenderHtmlAsPdf(html))
{
    return File(pdf.Stream, "application/pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

渲染器重用：在生成多个 PDF 时，跨请求共享 ChromePdfRenderer 实例以提高性能。渲染器是线程安全的，可以高效地处理并发操作。重用渲染器确实可以节省时间。千万不要错过这项优化。

根据微软的 ASP.NET Core 最佳实践，最大限度地减少对象分配和重用资源是实现高性能 Web 应用程序的关键。

使用 NuGet 安装

在 IronPDF 上查看 NuGet 快速安装。超过 1000 万次下载，它正以 C# 改变 PDF 开发。您也可以下载 DLL 或 Windows 安装程序。

结论

使用 IronPDF 即时创建 PDF 文档，可以将复杂的文档生成过程转化为简单的代码。从简单的发票到复杂的报告，IronPDF 强大的 SDK 可以处理繁重的工作，让您专注于应用程序逻辑。无需保存到磁盘即可生成和流式传输 PDF 文件，这使得您的 ASP.NET Core 应用程序更加高效和安全。我们不断融合新功能，您可以从我们所有的示例中汲取灵感。这是该图书馆的官方文档。

使用 IronPDF，您可以从 HTML 内容创建 PDF，将其作为字节数组进行流式传输，并立即向用户提供专业文档。无论您是构建报表系统、发票生成器还是文档管理解决方案，IronPDF 都能提供您实现强大的 PDF 生成所需的所有功能。您也可以撰写新消息以获取支持。文本内容清晰明了。

准备好使用动态 PDF 功能改造您的 ASP.NET Core 应用程序了吗？购买许可证即可解锁所有功能并获得我们工程团队的专业支持。

常见问题解答

如何在 ASP.NET Core 中动态生成 PDF 文件？

您可以使用 IronPDF 在 ASP.NET Core 中动态生成 PDF 文件，而无需将文件保存到磁盘。它允许您将 PDF 文件直接流式传输到浏览器。

使用 IronPDF 进行 PDF 生成有哪些好处？

IronPDF 提供了一个强大的渲染引擎，可以直接在 .NET Core 项目中动态创建 PDF，确保即时生成 PDF，而无需服务器端存储。

IronPDF 可以用来创建发票和报告吗？

是的，IronPDF 适用于创建各种类型的文档，例如发票、报告和证书，所有这些文档都可以在 ASP.NET Core 应用程序中即时生成。

使用 IronPDF 时是否需要服务器端存储？

不，IronPDF 允许您直接在浏览器中生成和传输 PDF 文件，而无需服务器端存储，因此高效快捷。

哪些类型的应用程序可以从即时生成 PDF 中受益？

现代网络应用程序，特别是那些需要实时创建文档的应用程序，如发票系统和报告工具，可以从 IronPDF 提供的即时 PDF 生成功能中受益匪浅。

IronPDF 是否支持 .NET Core 项目？

是的，IronPDF 与 .NET Core 项目完全兼容，允许开发人员将 PDF 生成功能无缝集成到他们的应用程序中。

Curtis Chau

立即与工程团队聊天

技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

如何使用 IronPDF for .NET 在 ASP.NET 中使用 C# 将 HTML 转换为 PDF

使用 IronPDF 创建 Telerik Blazo...

客户亮点：

开发者焦点：

网络研讨会：

ASP.NET Core 中的动态 PDF 生成：即时创建 PDF

即时创建 PDF 是什么意思？

如何设置 IronPDF 以生成动态 PDF 文件？

如何从HTML内容创建PDF文档？

示例输出

如何将 PDF 文件直接流式传输给用户而不保存到磁盘？

示例输出 PDF 文档

如何从动态数据库内容生成PDF？

即时生成 PDF 的最佳实践是什么？

结论

常见问题解答

如何在 ASP.NET Core 中动态生成 PDF 文件？

使用 IronPDF 进行 PDF 生成有哪些好处？

IronPDF 可以用来创建发票和报告吗？

使用 IronPDF 时是否需要服务器端存储？

哪些类型的应用程序可以从即时生成 PDF 中受益？

IronPDF 是否支持 .NET Core 项目？

ASP.NET Core 中的动态 PDF 生成：即时创建 PDF

即时创建 PDF 是什么意思？

如何设置 IronPDF 以生成动态 PDF 文件？

如何从HTML内容创建PDF文档？

示例输出

如何将 PDF 文件直接流式传输给用户而不保存到磁盘？

示例输出 PDF 文档

如何从动态数据库内容生成PDF？

即时生成 PDF 的最佳实践是什么？

结论

常见问题解答

如何在 ASP.NET Core 中动态生成 PDF 文件？

使用 IronPDF 进行 PDF 生成有哪些好处？

IronPDF 可以用来创建发票和报告吗？

使用 IronPDF 时是否需要服务器端存储？

哪些类型的应用程序可以从即时生成 PDF 中受益？

IronPDF 是否支持 .NET Core 项目？

相关文章

.NET PDF API 是 .NET 开发人员的指南。

如何使用 Aspose C# 和 IronPDF 创建 PDF

使用 IronPDF 创建 .NET Core PDF 生成器

下一步：开始免费 30 天试用

下一步：开始免费 30 天试用

深受全球 200 多万工程师信赖