使用IRONPDF

ASP.NET Core：使用IronPDF即时创建PDF

已更新:2026年2月27日

在 ASP.NET Core 中动态生成专业的 PDF 文档，方法是将 HTML 内容转换为精美的 PDF，并将其直接流式传输到浏览器——无需磁盘存储，无需管理临时文件。

在 ASP.NET Core 中构建现代 Web 应用程序时，按需生成PDF 文档的功能是一个反复出现的需求。发票需要在付款到账后立即下载。审计员点击"导出"后，合规性报告必须立即显示。证书应该在用户来得及怀疑是否出了问题之前就准备就绪。 IronPDF通过其基于 Chromium 的PDF 库处理所有这些场景，该库将 HTML（包括 CSS、JavaScript 和 Web 字体）转换为像素精确的 PDF 输出，而无需将任何内容写入磁盘。

本指南涵盖您需要了解的一切：安装库、从 HTML 字符串生成发票、从 Entity Framework 数据流式传输报告、应用页面标头和安全设置，以及采用最佳实践来保持高流量 ASP.NET 应用程序的良好性能。

即时创建 PDF 是什么意思？

"即时生成"是指在发出 HTTP 请求时，文档在内存中构建并直接发送给调用者。不会向文件系统写入 PDF 文件，不会在后台作业中排队处理工作，也不会在请求之间缓存结果。

这种方法之所以重要，原因有以下几点。首先，云部署目标（Azure 应用服务、AWS Lambda、Docker 容器）通常运行在本地文件系统是临时的或只读的环境中。在这些环境下，将 PDF 文件生成到临时文件夹然后再读取回来是不安全的。其次，避免磁盘写入可以减少攻击面：不会留下残留文件，后续请求可能会意外地将文件提供给错误的用户。第三，仅内存生成通常速度更快，因为它消除了关键路径中的两次 I/O 操作（写入和读取）。

IronPDF 的ChromePdfRenderer在每个生成的文档上公开一个 .BinaryData 属性和一个 .Stream 属性。两者都可以直接传递给 ASP.NET Core FileResult，从而在实践中实现流式传输只需一行代码。

立即开始使用 IronPDF。

如何在 ASP.NET Core 项目中安装 IronPDF？

可以通过程序包管理器控制台或 .NET CLI 添加 NuGet 程序包：

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

SHELL

安装软件包后，请在应用程序启动时设置您的许可证密钥——通常是在 Program.cs 中，在创建第一个渲染器之前：

using IronPdf;

// Place license activation before any IronPDF call
License.LicenseKey = "YOUR-LICENSE-KEY";

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register ChromePdfRenderer as a singleton so the Chromium engine
// is initialised once and reused across all requests.
builder.Services.AddSingleton<ChromePdfRenderer>();

var app = builder.Build();
app.MapDefaultControllerRoute();
app.Run();

using IronPdf;

// Place license activation before any IronPDF call
License.LicenseKey = "YOUR-LICENSE-KEY";

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();

// Register ChromePdfRenderer as a singleton so the Chromium engine
// is initialised once and reused across all requests.
builder.Services.AddSingleton<ChromePdfRenderer>();

var app = builder.Build();
app.MapDefaultControllerRoute();
app.Run();

Imports IronPdf

' Place license activation before any IronPDF call
License.LicenseKey = "YOUR-LICENSE-KEY"

Dim builder = WebApplication.CreateBuilder(args)
builder.Services.AddControllersWithViews()

' Register ChromePdfRenderer as a singleton so the Chromium engine
' is initialised once and reused across all requests.
builder.Services.AddSingleton(Of ChromePdfRenderer)()

Dim app = builder.Build()
app.MapDefaultControllerRoute()
app.Run()

$vbLabelText $csharpLabel

将 ChromePdfRenderer 注册为单例非常重要。渲染器首次使用时会启动一个内部 Chromium 子进程。如果每次请求都创建一个新实例，则每次调用都需要支付启动成本，这会在负载下增加数百毫秒的延迟。单例实例是线程安全的，无需额外配置即可处理并发渲染请求。

要更全面地了解安装选项（包括私有源的 NuGet.config 设置），请访问安装概述。

如何根据 HTML 字符串生成发票 PDF？

最常见的即时使用场景是生成交易文档——发票、收据、订单确认——其中内容会根据请求而变化，但布局保持不变。

模式是：构建一个包含插值数据的 HTML 字符串，将其传递给 RenderHtmlAsPdf，并将二进制结果作为文件下载返回。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class DocumentController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public DocumentController(ChromePdfRenderer renderer)
    {
        _renderer = renderer;
    }

    [HttpGet("invoice/{orderId:int}")]
    public IActionResult GetInvoice(int orderId)
    {
        // In a real application, fetch this from your database or order service.
        var order = GetOrderData(orderId);

        string html = $"""
            <!DOCTYPE html>
            <html lang="en">
            <head>
                <meta charset="utf-8">
                <style>
                    body  {{ font-family: Arial, sans-serif; margin: 40px; color: #333; }}
                    h1   {{ color: #1a56db; }}
                    table {{ width: 100%; border-collapse: collapse; margin-top: 24px; }}
                    th, td {{ padding: 10px 14px; border: 1px solid #d1d5db; text-align: left; }}
                    th   {{ background: #f3f4f6; }}
                    tfoot td {{ font-weight: bold; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{order.InvoiceNumber}</h1>
                <p>Date: {DateTime.UtcNow:yyyy-MM-dd} &nbsp;|&nbsp; Customer: {order.CustomerName}</p>
                <table>
                    <thead><tr><th>Item</th><th>Qty</th><th>Unit Price</th><th>Subtotal</th></tr></thead>
                    <tbody>
                        {string.Join("", order.Items.Select(i =>
                            $"<tr><td>{i.Name}</td><td>{i.Quantity}</td>" +
                            $"<td>${i.UnitPrice:F2}</td><td>${i.Quantity * i.UnitPrice:F2}</td></tr>"))}
                    </tbody>
                    <tfoot>
                        <tr><td colspan="3">Total</td><td>${order.Items.Sum(i => i.Quantity * i.UnitPrice):F2}</td></tr>
                    </tfoot>
                </table>
            </body>
            </html>
            """;

        var pdf = _renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf", $"invoice-{orderId}.pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

public class DocumentController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public DocumentController(ChromePdfRenderer renderer)
    {
        _renderer = renderer;
    }

    [HttpGet("invoice/{orderId:int}")]
    public IActionResult GetInvoice(int orderId)
    {
        // In a real application, fetch this from your database or order service.
        var order = GetOrderData(orderId);

        string html = $"""
            <!DOCTYPE html>
            <html lang="en">
            <head>
                <meta charset="utf-8">
                <style>
                    body  {{ font-family: Arial, sans-serif; margin: 40px; color: #333; }}
                    h1   {{ color: #1a56db; }}
                    table {{ width: 100%; border-collapse: collapse; margin-top: 24px; }}
                    th, td {{ padding: 10px 14px; border: 1px solid #d1d5db; text-align: left; }}
                    th   {{ background: #f3f4f6; }}
                    tfoot td {{ font-weight: bold; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{order.InvoiceNumber}</h1>
                <p>Date: {DateTime.UtcNow:yyyy-MM-dd} &nbsp;|&nbsp; Customer: {order.CustomerName}</p>
                <table>
                    <thead><tr><th>Item</th><th>Qty</th><th>Unit Price</th><th>Subtotal</th></tr></thead>
                    <tbody>
                        {string.Join("", order.Items.Select(i =>
                            $"<tr><td>{i.Name}</td><td>{i.Quantity}</td>" +
                            $"<td>${i.UnitPrice:F2}</td><td>${i.Quantity * i.UnitPrice:F2}</td></tr>"))}
                    </tbody>
                    <tfoot>
                        <tr><td colspan="3">Total</td><td>${order.Items.Sum(i => i.Quantity * i.UnitPrice):F2}</td></tr>
                    </tfoot>
                </table>
            </body>
            </html>
            """;

        var pdf = _renderer.RenderHtmlAsPdf(html);
        return File(pdf.BinaryData, "application/pdf", $"invoice-{orderId}.pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Public Class DocumentController
    Inherits Controller

    Private ReadOnly _renderer As ChromePdfRenderer

    Public Sub New(renderer As ChromePdfRenderer)
        _renderer = renderer
    End Sub

    <HttpGet("invoice/{orderId:int}")>
    Public Function GetInvoice(orderId As Integer) As IActionResult
        ' In a real application, fetch this from your database or order service.
        Dim order = GetOrderData(orderId)

        Dim html As String = $"
            <!DOCTYPE html>
            <html lang=""en"">
            <head>
                <meta charset=""utf-8"">
                <style>
                    body  {{ font-family: Arial, sans-serif; margin: 40px; color: #333; }}
                    h1   {{ color: #1a56db; }}
                    table {{ width: 100%; border-collapse: collapse; margin-top: 24px; }}
                    th, td {{ padding: 10px 14px; border: 1px solid #d1d5db; text-align: left; }}
                    th   {{ background: #f3f4f6; }}
                    tfoot td {{ font-weight: bold; }}
                </style>
            </head>
            <body>
                <h1>Invoice #{order.InvoiceNumber}</h1>
                <p>Date: {DateTime.UtcNow:yyyy-MM-dd} &nbsp;|&nbsp; Customer: {order.CustomerName}</p>
                <table>
                    <thead><tr><th>Item</th><th>Qty</th><th>Unit Price</th><th>Subtotal</th></tr></thead>
                    <tbody>
                        {String.Join("", order.Items.Select(Function(i) $"<tr><td>{i.Name}</td><td>{i.Quantity}</td>" +
                            $"<td>${i.UnitPrice:F2}</td><td>${i.Quantity * i.UnitPrice:F2}</td></tr>"))}
                    </tbody>
                    <tfoot>
                        <tr><td colspan=""3"">Total</td><td>${order.Items.Sum(Function(i) i.Quantity * i.UnitPrice):F2}</td></tr>
                    </tfoot>
                </table>
            </body>
            </html>
            "

        Dim pdf = _renderer.RenderHtmlAsPdf(html)
        Return File(pdf.BinaryData, "application/pdf", $"invoice-{orderId}.pdf")
    End Function
End Class

$vbLabelText $csharpLabel

RenderHtmlAsPdf 使用与 Google Chrome 相同的 Chromium 引擎处理完整的 HTML 文档——CSS 网格、Flexbox、网络字体，甚至内联 SVG。返回的 PdfDocument 暴露了 BinaryData（一个 byte[]）和 Stream（一个 MemoryStream）。将 BinaryData 传递给 File()，并传入 "application/pdf" 和文件名，即可触发浏览器下载。

对于需要像素级精确度的布局，请参阅HTML 到 PDF 渲染指南，其中涵盖响应式 CSS、自定义字体和JavaScript 渲染。

生成的发票 PDF 文件长什么样？

！专业PDF发票，发票编号123，日期为2025年11月13日，包含样式化的页眉部分，以及包含产品A（10.99美元）和产品B（5.49美元）的表格，展示了使用自定义CSS样式动态生成PDF的功能。

如何在不弹出下载对话框的情况下将 PDF 文件直接流式传输到浏览器？

以内联方式提供 PDF 文件（即在浏览器的内置查看器中打开而不是下载），需要进行两项小的更改：将 Content-Disposition 设置为 inline，并从 File() 调用中省略文件名。

[HttpPost("report/preview")]
public async Task<IActionResult> PreviewReport([FromBody] ReportRequest request)
{
    string html = BuildReportHtml(request);

    var pdfDocument = await _renderer.RenderHtmlAsPdfAsync(html);

    // "inline" tells the browser to display rather than download.
    Response.Headers["Content-Disposition"] = "inline; filename=report.pdf";

    return new FileContentResult(pdfDocument.BinaryData, "application/pdf");
}

[HttpPost("report/preview")]
public async Task<IActionResult> PreviewReport([FromBody] ReportRequest request)
{
    string html = BuildReportHtml(request);

    var pdfDocument = await _renderer.RenderHtmlAsPdfAsync(html);

    // "inline" tells the browser to display rather than download.
    Response.Headers["Content-Disposition"] = "inline; filename=report.pdf";

    return new FileContentResult(pdfDocument.BinaryData, "application/pdf");
}

Imports Microsoft.AspNetCore.Mvc

<HttpPost("report/preview")>
Public Async Function PreviewReport(<FromBody> request As ReportRequest) As Task(Of IActionResult)
    Dim html As String = BuildReportHtml(request)

    Dim pdfDocument = Await _renderer.RenderHtmlAsPdfAsync(html)

    ' "inline" tells the browser to display rather than download.
    Response.Headers("Content-Disposition") = "inline; filename=report.pdf"

    Return New FileContentResult(pdfDocument.BinaryData, "application/pdf")
End Function

$vbLabelText $csharpLabel

建议ASP.NET Core 控制器使用异步重载 RenderHtmlAsPdfAsync，因为它会在 Chromium 渲染时释放线程池线程，从而在并发负载下保持服务器的响应能力。

基于内存的PDF生成是如何工作的？

生成的 PDF 报告标题为"月度绩效评估"，其中包含格式化的内容，展示了如何生成实际的业务文档，包括图表、指标和详细分析部分，这些内容均由 HTML 模板渲染而成。

pdfDocument.BinaryData 字节数组完全驻留在托管内存中。不涉及中间文件路径。 Content-Disposition 标头控制 PDF 是内联显示还是作为下载提供——这是 HTTP 规范定义的浏览器行为。要深入了解 MemoryStream 方法，包括流式传输到 Azure Blob 存储，请访问PDF 内存流文档。

如何从 Entity Framework Core 查询结果生成 PDF？

大多数业务应用程序都从数据库中提取报表数据，而不是在调用时构建报表。以下模式查询Entity Framework Core ，构建 HTML 表格，并返回 PDF 文件——所有操作都在单个控制器操作中完成。

[HttpGet("report/monthly")]
public async Task<IActionResult> MonthlyReport(int year, int month)
{
    // Pull aggregated transaction data from EF Core.
    var rows = await _dbContext.Transactions
        .Where(t => t.Date.Year == year && t.Date.Month == month)
        .GroupBy(t => t.Category)
        .Select(g => new { Category = g.Key, Count = g.Count(), Total = g.Sum(t => t.Amount) })
        .OrderByDescending(g => g.Total)
        .ToListAsync();

    string tableRows = string.Join("", rows.Select(r =>
        $"<tr><td>{r.Category}</td><td>{r.Count}</td><td>${r.Total:F2}</td></tr>"));

    string html = $"""
        <html><body style="font-family:Arial,sans-serif;padding:32px">
        <h1>Monthly Report -- {month:D2}/{year}</h1>
        <table style="width:100%;border-collapse:collapse">
          <thead>
            <tr style="background:#e5e7eb">
              <th style="padding:8px;border:1px solid #d1d5db">Category</th>
              <th style="padding:8px;border:1px solid #d1d5db">Transactions</th>
              <th style="padding:8px;border:1px solid #d1d5db">Total</th>
            </tr>
          </thead>
          <tbody>{tableRows}</tbody>
        </table>
        </body></html>
        """;

    var pdf = _renderer.RenderHtmlAsPdf(html);
    pdf.MetaData.Title  = $"Monthly Report {month:D2}/{year}";
    pdf.MetaData.Author = "Reporting System";

    return File(pdf.BinaryData, "application/pdf", $"report-{year}-{month:D2}.pdf");
}

[HttpGet("report/monthly")]
public async Task<IActionResult> MonthlyReport(int year, int month)
{
    // Pull aggregated transaction data from EF Core.
    var rows = await _dbContext.Transactions
        .Where(t => t.Date.Year == year && t.Date.Month == month)
        .GroupBy(t => t.Category)
        .Select(g => new { Category = g.Key, Count = g.Count(), Total = g.Sum(t => t.Amount) })
        .OrderByDescending(g => g.Total)
        .ToListAsync();

    string tableRows = string.Join("", rows.Select(r =>
        $"<tr><td>{r.Category}</td><td>{r.Count}</td><td>${r.Total:F2}</td></tr>"));

    string html = $"""
        <html><body style="font-family:Arial,sans-serif;padding:32px">
        <h1>Monthly Report -- {month:D2}/{year}</h1>
        <table style="width:100%;border-collapse:collapse">
          <thead>
            <tr style="background:#e5e7eb">
              <th style="padding:8px;border:1px solid #d1d5db">Category</th>
              <th style="padding:8px;border:1px solid #d1d5db">Transactions</th>
              <th style="padding:8px;border:1px solid #d1d5db">Total</th>
            </tr>
          </thead>
          <tbody>{tableRows}</tbody>
        </table>
        </body></html>
        """;

    var pdf = _renderer.RenderHtmlAsPdf(html);
    pdf.MetaData.Title  = $"Monthly Report {month:D2}/{year}";
    pdf.MetaData.Author = "Reporting System";

    return File(pdf.BinaryData, "application/pdf", $"report-{year}-{month:D2}.pdf");
}

Imports Microsoft.AspNetCore.Mvc
Imports System.Threading.Tasks
Imports System.Linq

<HttpGet("report/monthly")>
Public Async Function MonthlyReport(year As Integer, month As Integer) As Task(Of IActionResult)
    ' Pull aggregated transaction data from EF Core.
    Dim rows = Await _dbContext.Transactions _
        .Where(Function(t) t.Date.Year = year AndAlso t.Date.Month = month) _
        .GroupBy(Function(t) t.Category) _
        .Select(Function(g) New With {Key .Category = g.Key, Key .Count = g.Count(), Key .Total = g.Sum(Function(t) t.Amount)}) _
        .OrderByDescending(Function(g) g.Total) _
        .ToListAsync()

    Dim tableRows As String = String.Join("", rows.Select(Function(r) $"<tr><td>{r.Category}</td><td>{r.Count}</td><td>${r.Total:F2}</td></tr>"))

    Dim html As String = $"
        <html><body style='font-family:Arial,sans-serif;padding:32px'>
        <h1>Monthly Report -- {month:D2}/{year}</h1>
        <table style='width:100%;border-collapse:collapse'>
          <thead>
            <tr style='background:#e5e7eb'>
              <th style='padding:8px;border:1px solid #d1d5db'>Category</th>
              <th style='padding:8px;border:1px solid #d1d5db'>Transactions</th>
              <th style='padding:8px;border:1px solid #d1d5db'>Total</th>
            </tr>
          </thead>
          <tbody>{tableRows}</tbody>
        </table>
        </body></html>
        "

    Dim pdf = _renderer.RenderHtmlAsPdf(html)
    pdf.MetaData.Title = $"Monthly Report {month:D2}/{year}"
    pdf.MetaData.Author = "Reporting System"

    Return File(pdf.BinaryData, "application/pdf", $"report-{year}-{month:D2}.pdf")
End Function

$vbLabelText $csharpLabel

设置 pdf.MetaData.Title 和 pdf.MetaData.Author 会将该信息嵌入到 PDF 文档属性中，这对于合规性跟踪和文档管理系统非常有用。对于更复杂的报告布局，请考虑使用CSS 打印样式、显式分页符和嵌入式图表图像。

如何为生成的 PDF 文件添加页眉、页脚和安全设置？

生产文档通常需要包含文档标题的页眉、页码页脚以及防止未经授权的打印或复制的访问控制。 IronPDF 的 ChromePdfRenderOptions 满足所有这些要求。

[HttpPost("document/secured")]
public async Task<IActionResult> GenerateSecuredDocument([FromBody] SecuredDocRequest request)
{
    var renderOptions = new ChromePdfRenderOptions
    {
        纸张尺寸       = Pdf纸张尺寸.A4,
        MarginTop       = 45,
        MarginBottom    = 45,
        MarginLeft      = 25,
        MarginRight     = 25,
        启用 JavaScript = true,
        WaitFor         = new WaitFor { RenderDelay = 500 }
    };

    renderOptions.TextHeader = new 文本页眉页脚
    {
        CenterText       = request.DocumentTitle,
        DrawDividerLine  = true,
        FontSize         = 11
    };

    renderOptions.TextFooter = new 文本页眉页脚
    {
        LeftText  = "{date} {time}",
        RightText = "Page {page} of {total-pages}",
        FontSize  = 9
    };

    _renderer.RenderingOptions = renderOptions;

    var pdf = await _renderer.RenderHtmlAsPdfAsync(request.HtmlContent);

    if (request.RequirePassword)
    {
        pdf.SecuritySettings.OwnerPassword         = request.OwnerPassword;
        pdf.SecuritySettings.UserPassword          = request.UserPassword;
        pdf.SecuritySettings.AllowUserPrinting     = PdfPrintSecurity.NoPrint;
        pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    }

    return File(pdf.BinaryData, "application/pdf", $"{request.FileName}.pdf");
}

[HttpPost("document/secured")]
public async Task<IActionResult> GenerateSecuredDocument([FromBody] SecuredDocRequest request)
{
    var renderOptions = new ChromePdfRenderOptions
    {
        纸张尺寸       = Pdf纸张尺寸.A4,
        MarginTop       = 45,
        MarginBottom    = 45,
        MarginLeft      = 25,
        MarginRight     = 25,
        启用 JavaScript = true,
        WaitFor         = new WaitFor { RenderDelay = 500 }
    };

    renderOptions.TextHeader = new 文本页眉页脚
    {
        CenterText       = request.DocumentTitle,
        DrawDividerLine  = true,
        FontSize         = 11
    };

    renderOptions.TextFooter = new 文本页眉页脚
    {
        LeftText  = "{date} {time}",
        RightText = "Page {page} of {total-pages}",
        FontSize  = 9
    };

    _renderer.RenderingOptions = renderOptions;

    var pdf = await _renderer.RenderHtmlAsPdfAsync(request.HtmlContent);

    if (request.RequirePassword)
    {
        pdf.SecuritySettings.OwnerPassword         = request.OwnerPassword;
        pdf.SecuritySettings.UserPassword          = request.UserPassword;
        pdf.SecuritySettings.AllowUserPrinting     = PdfPrintSecurity.NoPrint;
        pdf.SecuritySettings.AllowUserCopyPasteContent = false;
    }

    return File(pdf.BinaryData, "application/pdf", $"{request.FileName}.pdf");
}

Imports Microsoft.AspNetCore.Mvc

<HttpPost("document/secured")>
Public Async Function GenerateSecuredDocument(<FromBody> request As SecuredDocRequest) As Task(Of IActionResult)
    Dim renderOptions As New ChromePdfRenderOptions With {
        .纸张尺寸 = Pdf纸张尺寸.A4,
        .MarginTop = 45,
        .MarginBottom = 45,
        .MarginLeft = 25,
        .MarginRight = 25,
        .启用JavaScript = True,
        .WaitFor = New WaitFor With {.RenderDelay = 500}
    }

    renderOptions.TextHeader = New 文本页眉页脚 With {
        .CenterText = request.DocumentTitle,
        .DrawDividerLine = True,
        .FontSize = 11
    }

    renderOptions.TextFooter = New 文本页眉页脚 With {
        .LeftText = "{date} {time}",
        .RightText = "Page {page} of {total-pages}",
        .FontSize = 9
    }

    _renderer.RenderingOptions = renderOptions

    Dim pdf = Await _renderer.RenderHtmlAsPdfAsync(request.HtmlContent)

    If request.RequirePassword Then
        pdf.SecuritySettings.OwnerPassword = request.OwnerPassword
        pdf.SecuritySettings.UserPassword = request.UserPassword
        pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.NoPrint
        pdf.SecuritySettings.AllowUserCopyPasteContent = False
    End If

    Return File(pdf.BinaryData, "application/pdf", $"{request.FileName}.pdf")
End Function

$vbLabelText $csharpLabel

当您的 HTML 包含 Chart.js 或 ApexCharts 等图表库，而这些图表库会异步完成绘制时，WaitFor.RenderDelay 设置特别有用。设置 300-500 毫秒的延迟可确保 Chromium 捕获最终渲染状态。对于需要符合归档标准的文档，将上述方法与PDF/A 合规性和数字签名相结合。

页脚文本中的 {page} 和 {total-pages} 标记由 IronPDF 在渲染时自动解析。其他页眉和页脚选项包括用于放置徽标的基于 HTML 的页眉以及按章节覆盖功能。

有哪些渲染选项？

下表总结了用于即时生成的最有用的 ChromePdfRenderOptions 属性：

常用的 ChromePdfRenderOptions 属性
属性	翻译类型	翻译目的
纸张尺寸	Pdf纸张尺寸	设置页面尺寸（A4、Letter、Legal、自定义）
上边距/下边距	整数（毫米）	控制打印区域间距
启用 JavaScript	布尔值	允许在捕获之前执行 JS 操作
WaitFor.RenderDelay	整数（毫秒）	延迟捕获以进行异步渲染
文本页眉/文本页脚	文本页眉页脚	页面页眉和页脚
HTML页眉/HTML页脚	HtmlHeaderFooter	带有图片的 HTML 格式页眉/页脚
灰度	布尔值	输出单色 PDF
适应纸张宽度	布尔值	将宽内容缩放以适应页面

高容量 PDF 生成的最佳性能实践是什么？

当单个服务器处理数百个并发 PDF 请求时，一些架构决策会对吞吐量和延迟产生巨大的影响。

单例渲染器注册。如安装部分所示，将 ChromePdfRenderer 注册为依赖注入容器中的单例，可以避免每次请求都启动一个新的 Chromium 子进程所带来的开销。根据微软的 ASP.NET Core 性能指南，减少对象分配和重用高成本资源是两种最有效的优化方法。

始终使用 async。 RenderHtmlAsPdfAsync 返回一个 Task<PdfDocument> 并在 Chromium 运行时挂起控制器线程。这样可以释放线程池，使其能够并行处理其他传入的请求，这也是异步文档建议 Web 主机使用此重载的原因。同步重载仅适用于可以接受线程阻塞的控制台工具或后台服务。

直接传输数据，尽可能跳过中间数组。对于大型 PDF 文件，可以直接将 .Stream 写入响应体，而无需实例化完整的字节数组：

[HttpGet("document/large")]
public IActionResult StreamLargeDocument(int documentId)
{
    string html = BuildLargeDocumentHtml(documentId);
    var pdf = _renderer.RenderHtmlAsPdf(html);

    // Stream.Position is already at 0; no seek needed.
    return File(pdf.Stream, "application/pdf", $"document-{documentId}.pdf");
}

[HttpGet("document/large")]
public IActionResult StreamLargeDocument(int documentId)
{
    string html = BuildLargeDocumentHtml(documentId);
    var pdf = _renderer.RenderHtmlAsPdf(html);

    // Stream.Position is already at 0; no seek needed.
    return File(pdf.Stream, "application/pdf", $"document-{documentId}.pdf");
}

Imports Microsoft.AspNetCore.Mvc

<HttpGet("document/large")>
Public Function StreamLargeDocument(documentId As Integer) As IActionResult
    Dim html As String = BuildLargeDocumentHtml(documentId)
    Dim pdf = _renderer.RenderHtmlAsPdf(html)

    ' Stream.Position is already at 0; no seek needed.
    Return File(pdf.Stream, "application/pdf", $"document-{documentId}.pdf")
End Function

$vbLabelText $csharpLabel

使用后请处置。 PdfDocument 实现了 IDisposable。将其包装在 using 语句中可以立即释放底层内存缓冲区，这在连续生成多个大型 PDF 时非常重要：

using var pdf = _renderer.RenderHtmlAsPdf(html);
byte[] data = pdf.BinaryData;
// pdf is disposed here; data is safely copied to the local array.
return File(data, "application/pdf", "output.pdf");

using var pdf = _renderer.RenderHtmlAsPdf(html);
byte[] data = pdf.BinaryData;
// pdf is disposed here; data is safely copied to the local array.
return File(data, "application/pdf", "output.pdf");

Imports System.IO

Using pdf = _renderer.RenderHtmlAsPdf(html)
    Dim data As Byte() = pdf.BinaryData
    ' pdf is disposed here; data is safely copied to the local array.
    Return File(data, "application/pdf", "output.pdf")
End Using

$vbLabelText $csharpLabel

IronPDF 文档针对Azure 、AWS、Docker 和 Linux 环境提供了云部署指导，并提供了特定于环境的配置说明。如果启动后的第一次渲染速度较慢，请参考预热和缓存指南，了解在第一个用户请求到达之前预初始化渲染器的策略。

如何在生成的PDF文件中添加水印？

在流式传输之前，可以在生成的文档的每一页上添加文本或图像水印：

[HttpGet("document/draft/{id:int}")]
public IActionResult GetDraftDocument(int id)
{
    string html = BuildDocumentHtml(id);
    var pdf = _renderer.RenderHtmlAsPdf(html);

    // Stamp "DRAFT" diagonally across every page.
    pdf.ApplyWatermark(
        "<h1 style='color:rgba(200,0,0,0.25);transform:rotate(-45deg)'>DRAFT</h1>",
        rotation: 45,
        opacity: 30
    );

    return File(pdf.BinaryData, "application/pdf", $"draft-{id}.pdf");
}

[HttpGet("document/draft/{id:int}")]
public IActionResult GetDraftDocument(int id)
{
    string html = BuildDocumentHtml(id);
    var pdf = _renderer.RenderHtmlAsPdf(html);

    // Stamp "DRAFT" diagonally across every page.
    pdf.ApplyWatermark(
        "<h1 style='color:rgba(200,0,0,0.25);transform:rotate(-45deg)'>DRAFT</h1>",
        rotation: 45,
        opacity: 30
    );

    return File(pdf.BinaryData, "application/pdf", $"draft-{id}.pdf");
}

<AttributeUsage(AttributeTargets.Method, Inherited:=True, AllowMultiple:=False)>
Public Class HttpGetAttribute
    Inherits Attribute

    Public Sub New(route As String)
    End Sub
End Class

<HttpGet("document/draft/{id:int}")>
Public Function GetDraftDocument(id As Integer) As IActionResult
    Dim html As String = BuildDocumentHtml(id)
    Dim pdf = _renderer.RenderHtmlAsPdf(html)

    ' Stamp "DRAFT" diagonally across every page.
    pdf.ApplyWatermark(
        "<h1 style='color:rgba(200,0,0,0.25);transform:rotate(-45deg)'>DRAFT</h1>",
        rotation:=45,
        opacity:=30
    )

    Return File(pdf.BinaryData, "application/pdf", $"draft-{id}.pdf")
End Function

$vbLabelText $csharpLabel

有关完整的水印配置选项（包括图像水印和每页控制），请参阅水印文档。

使用 NuGet 安装

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

下一步计划是什么？

ASP.NET Core 中的动态 PDF 生成遵循一致的模式：构建 HTML，调用 RenderHtmlAsPdf 或其异步重载，并通过 FileResult 返回结果。 IronPDF 可以处理中间的所有步骤——Chromium 渲染、CSS 应用、JavaScript 执行——而无需在任何阶段进行磁盘 I/O。

从这里出发，您可以根据自己的应用需求探索多个方向。如果您的 PDF 需要合并多个源文档，合并和拆分指南涵盖了如何将现有 PDF 与新渲染的页面连接起来。如果您需要用户填写并提交嵌入在 PDF 中的表单，交互式表单文档将展示如何创建和读取字段值。对于受监管的行业， PDF/A 合规性和PDF/UA 可访问性可确保文档符合存档和可访问性标准。

如果您正在评估 IronPDF 与其他替代方案， iText 与 IronPDF 的比较提供了并排的技术分析。准备好投入生产时，请购买许可证以解锁所有功能并获得优先工程支持。完整的API 参考文档包含了本指南中讨论的每个类和方法。

如果在实施过程中遇到任何问题，工程支持团队随时为您提供帮助。关于Blazor Server或 MAUI 等平台的具体说明，我们提供了专门的指南，其中涵盖了每种主机型号的配置差异。

常见问题解答

如何在 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 机器人，将他对技术的热爱与创造力相结合。

已更新2026年3月30日

生成每月账户报表（PDF 文档）

使用 IronPDF C# PDF 库，开发人员可以在 .NET 项目中将 HTML 转换为可靠的 PDF 文件，而无需依赖外部服务。

已更新2026年3月30日

使用 IronPDF 将在线申请表转换为 PDF 摘要

了解如何使用 IronPDF 生成 Web 表单提交的可追溯记录——这对于政府合规目的非常有用。

已更新2026年3月30日

适用于金融科技应用的 C# PDF 收据和交易记录

阅读本文，了解如何使用 IronPDF 在服务点创建可追溯、带时间戳的交易记录。

使用 Telerik Blazor PDF 查看器...

客户亮点：

开发者焦点：

网络研讨会：

立即开始30天免费试用

ASP.NET Core：使用IronPDF即时创建PDF

即时创建 PDF 是什么意思？

如何在 ASP.NET Core 项目中安装 IronPDF？

如何根据 HTML 字符串生成发票 PDF？

生成的发票 PDF 文件长什么样？

如何在不弹出下载对话框的情况下将 PDF 文件直接流式传输到浏览器？

基于内存的PDF生成是如何工作的？

如何从 Entity Framework Core 查询结果生成 PDF？

如何为生成的 PDF 文件添加页眉、页脚和安全设置？

有哪些渲染选项？

高容量 PDF 生成的最佳性能实践是什么？

如何在生成的PDF文件中添加水印？

下一步计划是什么？

常见问题解答

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

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

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

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

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

IronPDF 是否支持 .NET Core 项目？

钢铁支援团队

立即开始30天免费试用

ASP.NET Core：使用IronPDF即时创建PDF

即时创建 PDF 是什么意思？

如何在 ASP.NET Core 项目中安装 IronPDF？

如何根据 HTML 字符串生成发票 PDF？

生成的发票 PDF 文件长什么样？

如何在不弹出下载对话框的情况下将 PDF 文件直接流式传输到浏览器？

基于内存的PDF生成是如何工作的？

如何从 Entity Framework Core 查询结果生成 PDF？

如何为生成的 PDF 文件添加页眉、页脚和安全设置？

有哪些渲染选项？

高容量 PDF 生成的最佳性能实践是什么？

如何在生成的PDF文件中添加水印？

下一步计划是什么？

常见问题解答

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

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

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

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

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

IronPDF 是否支持 .NET Core 项目？

相关文章

生成每月账户报表（PDF 文档）

使用 IronPDF 将在线申请表转换为 PDF 摘要

适用于金融科技应用的 C# PDF 收据和交易记录

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

深受全球数百万工程师信赖

钢铁支援团队