使用IRONPDF

如何在 ASP.NET C# 中创建 PDF

已发布:十一月 13, 2025

如果您曾经在 ASP.NET C# 中生成格式化的 PDF 文件时感到头疼，您会知道这有多令人沮丧。需要专业的发票、详细的报告和正式的文件是一个常态，但传统的 PDF API 的复杂性常常阻碍了这一过程。

幸运的是，IronPDF 解决了这种复杂性。这个强大的 .NET PDF 库简化了整个过程，为您提供完整的代码和工具，可以快速生成美观、可靠的 PDF 文档。

什么使 PDF 生成在 ASP.NET Core 中变得必不可少？

PDF 文档作为跨不同平台和设备共享格式化内容的通用标准。在 ASP.NET Core 应用程序中，生成 PDF 文件使企业能够创建专业的发票、详细的报告和正式的文件，无论在何种查看环境下都能保持其格式。服务器端 PDF 生成提供一致的输出、更好的安全控制，并消除对客户端资源的依赖。

直接将HTML 内容转换为 PDF 格式的能力开辟了强大的可能性。您可以利用现有的 HTML 和 CSS 知识创建精美格式化的 PDF 文档，而无需学习复杂的 PDF 专用 API。这种方法使您可以从现有网页、Razor 视图或自定义 HTML 字符串中生成 PDF 文件，几乎不费吹灰之力。

IronPDF 如何简化 PDF 创建？

IronPDF 在其他 PDF 生成库中脱颖而出，因其基于 Chrome 的渲染引擎确保了准确的 HTML 到 PDF 转换。此引擎支持现代 Web 标准，包括 CSS3、JavaScript 和响应式布局，使其可以创建看起来与 HTML 对应的 PDF 文档。

该库简单的 API 设计意味着您可以立即开始生成 PDF，而无需进行广泛的配置。 IronPDF 在后台处理 PDF 文件创建的复杂性，从管理字体和图像到正确渲染复杂布局。无论您是需要从简单的 HTML 字符串生成 PDF，还是转换整个网页，过程始终十分简单。对许多开发者来说，它是一个强大的开源库。

如何在 ASP.NET Core 中开始使用 IronPDF？

在 ASP.NET Core 项目中设置 IronPDF 使用 NuGet 包管理器非常简单。在 Visual Studio 中打开您的包管理器控制台并运行以下命令：

Install-Package IronPdf

一旦安装，您将可以访问完整的 IronPDF 库，并可以立即开始创建 PDF 文件。 For production use, you'll need to apply a license key, but the free version allows full development and testing.

如何从简单的 HTML 字符串创建 PDF 文档？

让我们从一个简单的例子开始，演示如何从 HTML 字符串创建 PDF 文件。这个例子展示了生成 PDF 文档的基本方法：

using IronPdf;

public class PdfGenerator
{
    public void CreateSimplePdf()
    {
        // Create a new PDF document
        var renderer = new ChromePdfRenderer();
        // Generate PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF file in C#!</p>");
        // Save the PDF file
        pdf.SaveAs("simple-document.pdf");
    }
}

using IronPdf;

public class PdfGenerator
{
    public void CreateSimplePdf()
    {
        // Create a new PDF document
        var renderer = new ChromePdfRenderer();
        // Generate PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is my first PDF file in C#!</p>");
        // Save the PDF file
        pdf.SaveAs("simple-document.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

输出 PDF 文件

How to Create a PDF in ASP.NET C#: Figure 1 - Simple HTML to PDF output

这段代码创建了一个包含基础 HTML 内容的新文档。 ChromePdfRenderer 类处理所有的转换细节，将您的 HTML 转化为格式良好的 PDF 文件。生成的文档在转换为便携式文档格式时保持 HTML 结构。您还可以在我们的网站上找到有用的 PDF 教程和完整的代码示例。

如何生成复杂 HTML 的 PDF 文档？

IronPDF 在将复杂的 HTML 内容渲染成 PDF 文档方面表现出色。让我们创建一个更复杂的发票文档，以展示库与样式化 HTML 内容的能力：

using IronPdf;
using System;

public class InvoiceGenerator
{
    public void CreateInvoiceDocument()
    {
        var renderer = new ChromePdfRenderer();
        // HTML content with styling
        string htmlContent = @"
        <!DOCTYPE html>
        <html>
        <head>
            <style>
                body { font-family: 'Arial', sans-serif; margin: 40px; }
                .header { background-color: #003366; color: white; padding: 20px; text-align: center; }
                .invoice-details { margin: 20px 0; }
                table { width: 100%; border-collapse: collapse; margin-top: 20px; }
                th { background-color: #f0f0f0; padding: 10px; text-align: left; }
                td { padding: 10px; border-bottom: 1px solid #ddd; }
                .total { font-size: 18px; font-weight: bold; text-align: right; margin-top: 20px; }
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>INVOICE</h1>
            </div>
            <div class='invoice-details'>
                <p><strong>Invoice Number:</strong> INV-2024-001</p>
                <p><strong>Date:</strong> " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
                <p><strong>Customer:</strong> ABC Corporation</p>
            </div>
            <table>
                <thead>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                        <th>Total</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td>Professional Services</td>
                        <td>10</td>
                        <td>$150.00</td>
                        <td>$1,500.00</td>
                    </tr>
                    <tr>
                        <td>Software License</td>
                        <td>1</td>
                        <td>$499.00</td>
                        <td>$499.00</td>
                    </tr>
                </tbody>
            </table>
            <div class='total'>
                Total Amount: $1,999.00
            </div>
        </body>
        </html>";
        // Generate PDF file
        var document = renderer.RenderHtmlAsPdf(htmlContent);
        document.SaveAs("invoice.pdf");
    }
}

using IronPdf;
using System;

public class InvoiceGenerator
{
    public void CreateInvoiceDocument()
    {
        var renderer = new ChromePdfRenderer();
        // HTML content with styling
        string htmlContent = @"
        <!DOCTYPE html>
        <html>
        <head>
            <style>
                body { font-family: 'Arial', sans-serif; margin: 40px; }
                .header { background-color: #003366; color: white; padding: 20px; text-align: center; }
                .invoice-details { margin: 20px 0; }
                table { width: 100%; border-collapse: collapse; margin-top: 20px; }
                th { background-color: #f0f0f0; padding: 10px; text-align: left; }
                td { padding: 10px; border-bottom: 1px solid #ddd; }
                .total { font-size: 18px; font-weight: bold; text-align: right; margin-top: 20px; }
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>INVOICE</h1>
            </div>
            <div class='invoice-details'>
                <p><strong>Invoice Number:</strong> INV-2024-001</p>
                <p><strong>Date:</strong> " + DateTime.Now.ToString("yyyy-MM-dd") + @"</p>
                <p><strong>Customer:</strong> ABC Corporation</p>
            </div>
            <table>
                <thead>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                        <th>Total</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td>Professional Services</td>
                        <td>10</td>
                        <td>$150.00</td>
                        <td>$1,500.00</td>
                    </tr>
                    <tr>
                        <td>Software License</td>
                        <td>1</td>
                        <td>$499.00</td>
                        <td>$499.00</td>
                    </tr>
                </tbody>
            </table>
            <div class='total'>
                Total Amount: $1,999.00
            </div>
        </body>
        </html>";
        // Generate PDF file
        var document = renderer.RenderHtmlAsPdf(htmlContent);
        document.SaveAs("invoice.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

输出 PDF 文件 File

How to Create a PDF in ASP.NET C#: Figure 2 - Complex HTML to PDF output

以上代码展示了 IronPDF 如何处理复杂的 HTML 结构、CSS 样式和动态内容来创建专业的 PDF 文档。生成的 PDF 文件保持所有格式，使其非常适合商业文档生成。

如何在 ASP.NET Core MVC 控制器中生成 PDF 文件？

在 ASP.NET Core MVC 应用程序中，您通常会在控制器操作中生成 PDF 文件，并将其返回给用户下载。以下代码片段展示了如何在控制器中使用最新版本实现 PDF 生成：

using Microsoft.AspNetCore.Mvc;
using IronPdf;
using System.IO;

public class DocumentController : Controller
{
    public IActionResult GenerateReport()
    {
        var renderer = new ChromePdfRenderer();
        // Configure rendering options
        renderer.RenderingOptions.MarginTop = 25;
        renderer.RenderingOptions.MarginBottom = 25;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        string htmlString = @"
        <html>
        <head>
            <style>
                body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; }
                h1 { color: #2c3e50; }
                .report-content { line-height: 1.6; }
            </style>
        </head>
        <body>
            <h1>Monthly Sales Report</h1>
            <div class='report-content'>
                <p>This report contains confidential sales data for the current month.</p>
                <p>Total Revenue: $45,678</p>
                <p>New Customers: 123</p>
            </div>
        </body>
        </html>";
        // Create PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlString);
        // Convert to byte array
        byte[] pdfBytes = pdfDocument.BinaryData;
        // Return file
        return File(pdfBytes, "application/pdf", "sales-report.pdf");
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;
using System.IO;

public class DocumentController : Controller
{
    public IActionResult GenerateReport()
    {
        var renderer = new ChromePdfRenderer();
        // Configure rendering options
        renderer.RenderingOptions.MarginTop = 25;
        renderer.RenderingOptions.MarginBottom = 25;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        string htmlString = @"
        <html>
        <head>
            <style>
                body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; }
                h1 { color: #2c3e50; }
                .report-content { line-height: 1.6; }
            </style>
        </head>
        <body>
            <h1>Monthly Sales Report</h1>
            <div class='report-content'>
                <p>This report contains confidential sales data for the current month.</p>
                <p>Total Revenue: $45,678</p>
                <p>New Customers: 123</p>
            </div>
        </body>
        </html>";
        // Create PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlString);
        // Convert to byte array
        byte[] pdfBytes = pdfDocument.BinaryData;
        // Return file
        return File(pdfBytes, "application/pdf", "sales-report.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

ASP.NET PDF 输出

How to Create a PDF in ASP.NET C#: Figure 3 - ASP.NET HTML to PDF output

此控制器动作生成 PDF 文档，并将其作为可下载的文件返回。渲染选项允许您自定义边距并指定 CSS 媒体类型以获得最佳 PDF 格式输出。下载文件的名称是"sales-report.pdf"。

如何轻松从 URL 和 HTML 文件生成 PDF 文件？

IronPDF can also convert existing web pages and HTML files directly to PDF format. 这在需要从现有内容生成 PDF 时特别有用：

using IronPdf;

public class WebPageConverter
{
    public void ConvertUrlToPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitFor.RenderDelay(1000);
        // Convert URL to PDF
        var urlPdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        urlPdf.SaveAs("webpage.pdf");
    }

    public void ConvertHtmlFileToPdf()
    {
        var renderer = new ChromePdfRenderer();
        // Convert HTML file to PDF
        var htmlFile = renderer.RenderHtmlFileAsPdf("template.html");
        htmlFile.SaveAs("from-file.pdf");
    }
}

using IronPdf;

public class WebPageConverter
{
    public void ConvertUrlToPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen;
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitFor.RenderDelay(1000);
        // Convert URL to PDF
        var urlPdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        urlPdf.SaveAs("webpage.pdf");
    }

    public void ConvertHtmlFileToPdf()
    {
        var renderer = new ChromePdfRenderer();
        // Convert HTML file to PDF
        var htmlFile = renderer.RenderHtmlFileAsPdf("template.html");
        htmlFile.SaveAs("from-file.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

URL 到 PDF 输出

How to Create a PDF in ASP.NET C#: Figure 4 - URL to PDF output

这两种方法在创建 PDF 文件时保留原始内容的完整代码布局、图像和样式。如果发生错误，请确保检查文件路径。

如何向 PDF 文档添加页眉和页脚？

为 PDF 文档添加专业的页眉和页脚可以增强其外观，并提供重要背景信息，如页码和文档标题。以下代码示例展示了如何做到这一点：

using IronPdf;

public class HeaderFooterExample
{
    public void CreatePdfWithHeaderFooter()
    {
        var renderer = new ChromePdfRenderer();
        // Configure headers and footers
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align:center'>Company Report</div>",
            DrawDividerLine = true
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>",
            DrawDividerLine = true
        };
        // HTML content for the main document
        string content = "<h1>Annual Report</h1><p>This document contains important information.</p>";
        // Generate PDF with headers and footers
        var doc = renderer.RenderHtmlAsPdf(content);
        doc.SaveAs("report-with-headers.pdf");
    }
}

using IronPdf;

public class HeaderFooterExample
{
    public void CreatePdfWithHeaderFooter()
    {
        var renderer = new ChromePdfRenderer();
        // Configure headers and footers
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align:center'>Company Report</div>",
            DrawDividerLine = true
        };
        renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>",
            DrawDividerLine = true
        };
        // HTML content for the main document
        string content = "<h1>Annual Report</h1><p>This document contains important information.</p>";
        // Generate PDF with headers and footers
        var doc = renderer.RenderHtmlAsPdf(content);
        doc.SaveAs("report-with-headers.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

输出 PDF 文件 with Headers

How to Create a PDF in ASP.NET C#: Figure 5 - Generated PDF with headers

{page} 和 {total-pages} 占位符自动填充正确的页码，创建出专业外观的 PDF 文件。这使您可以为现有文档对象添加新的页面。

结论

在 IronPDF 的帮助下创建 PDF ASP.NET C# 任务的过程将本可能很复杂的任务变成了一个简单的过程。从简单的 HTML 字符串到复杂的发票文档，IronPDF 的 Chrome 渲染引擎确保您的 PDF 文档看起来与设计相同。该库直观的 API 允许您用最少的代码生成 PDF 文件、修改 PDF 文件并处理现有的 PDF 文档。您还可以轻松管理数字签名。使用控制台应用程序模板或 ASP.NET 是灵活的。

无论您是为商务报告生成 PDF，还是从网页创建 PDF 文档，或者将 HTML 内容转换为可移植文档格式，IronPDF 都提供您所需的所有工具。准备好在 .NET 应用程序中开始创建专业 PDF 文件了吗？

今天安装 IronPDF 并体验使用正确的 .NET 库进行 PDF 生成的简单。查阅详细文档了解更多信息。 IronPDF 支持 .NET Framework 和 .NET Core。

对于生产部署，请探索适合您项目需求的全面许可选项。使用 IronPDF 您只需几行代码就可以在 ASP.NET Core 应用程序中进行功能强大的 PDF 文档生成。