使用IRONPDF

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

發表日期:11月 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 转换。此引擎支持包括 CSS3、JavaScript 和响应式布局在内的现代 Web 标准，使得创建外观与其 HTML 对应物完全一致的 PDF 文档成为可能。

该库的简单 API 设计意味着您可以立即开始生成 PDFs，而无需大量配置。 IronPDF 处理了幕后的 PDF 文件创建复杂性，从字体和图像的管理到复杂布局的正确渲染。无论您是需要从简单的 HTML 字符串生成 PDF，还是转换整个网页，过程始终简洁。这是许多开发人员强大的开源库。

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

使用 NuGet 包管理器在您的 ASP.NET Core 项目中设置 IronPDF 非常简单。在 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

如何在 ASP.NET C# 中创建 PDF：图 1 - 简单的 HTML 到 PDF 输出

此代码通过基本 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

如何在 ASP.NET C# 中创建 PDF：图 2 - 复杂的 HTML 到 PDF 输出

上面的代码演示了 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 输出

如何在 ASP.NET C# 中创建 PDF：图 3 - ASP.NET HTML 到 PDF 输出

此控制器操作生成 PDF 文档并将其作为可下载文件返回。渲染选项允许您自定义边距并为最佳 PDF 格式输出指定 CSS 媒体类型。下载文件的文件名为"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 输出

如何在 ASP.NET C# 中创建 PDF：图 4 - URL 到 PDF 输出

这两种方法在创建 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

如何在 ASP.NET C# 中创建 PDF：图 5 - 生成的 PDF 带有标题

{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 文档生成。