跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. 使用IronPDF
  4. ASP HTML 转 PDF
使用IRONPDF

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

Curtis Chau
Curtis Chau
已更新:

将动态ASP.NET HTML转换为PDF文档是现代ASP.NET应用程序中的基本需求。 无论您是在生成发票、创建报告，还是生成可下载的PDF文件，能够将HTML内容转化为专业的PDF文档对于提供精致的用户体验至关重要。

IronPDF通过提供强大的基于Chrome的渲染引擎简化了ASP HTML到PDF的转换过程，完美地保留了HTML格式、CSS样式和JavaScript功能在生成的PDF文档中。 本教程将引导您了解使用IronPDF 库在ASP.NET Core 应用程序中将 HTML 转换为 PDF 的有效方法。

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 1 - IronPDF

为什么开发人员需要进行HTML到PDF的转换？

ASP.NET Core应用程序通常生成动态的HTML内容，用户需要将其作为PDF文件下载、共享或存档。 与简单地保存网页或进行截图相比，HTML到PDF的转换提供了几个关键优势。

PDF文档在所有设备和平台上保持一致的格式，无论是在Windows、Mac还是移动设备上查看，确保您的发票外观相同。 它们对于需要数字签名、安全设置或专业打印的现有文档也非常理想。 服务器端的PDF转换消除了用户需要安装特定软件的需求，并提供了对最终PDF文件输出的更好控制。

常见的用例包括从仪表板数据生成财务报告，从订单信息创建可下载的发票，用QR码生成票证和通行证，以及将表单提交转换为永久记录。 通过在服务器上处理ASP HTML到PDF的转换，您可以确保结果的一致性，而不管用户的浏览器或设备能力如何。

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 2 - 功能

IronPDF安装是如何工作的？

在ASP.NET Core项目中开始使用IronPDF非常简单。 该库支持.NET Core 2.0及以上版本，以及.NET 5、6、7和8，使其与所有现代ASP.NET Core应用程序的HTML到PDF转换任务兼容。

通过NuGet包管理器安装

将IronPDF添加到ASP.NET项目中以进行HTML到PDF的转换的最快方法是通过Visual Studio中的NuGet包管理器。 在解决方案资源管理器中右键点击您的项目，选择"管理NuGet包"，然后搜索IronPDF。 点击安装最新版本以将其添加到您的项目中。 有关详细的安装说明，请参阅 IronPDF安装指南。

Install-Package IronPdf

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 3 - 安装

添加所需的命名空间

安装完成后，在任何您将使用PDF生成的C#文件中添加IronPDF命名空间：

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel

这条简单的导入语句让您可以访问 IronPDF 的所有功能，包括用于 HTML 转换的 ChromePdfRenderer 类以及用于自定义 PDF 输出的各种配置选项。

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 4 - ASP HTML 转 PDF - IronPDF

基本配置

对于大多数ASP.NET Core应用程序，IronPDF在安装后立即工作，无需额外配置。 然而，您可以在Program.cs或Startup.cs文件中设置全局选项：

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;
// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这些配置选项有助于优化IronPDF以适应您的特定托管环境，无论您是在Windows上运行、Linux上，还是在Docker容器中。 确保脚本和应用程序文件不在同一目录中以防止冲突。

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 5 - 跨平台兼容性

如何将HTML字符串转换为PDF？

IronPDF中最基本的操作是将HTML字符串直接转换为PDF文档。 这种方式适合在ASP.NET应用程序中动态构建HTML内容或将HTML文档作为模板使用时。

// Create a PDF converter instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF document
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Report</h1><p>Generated on: " + DateTime.Now + "</p>");
// Save the resultant PDF document to a file
pdf.SaveAs("report.pdf");
// Create a PDF converter instance
var renderer = new ChromePdfRenderer();
// Convert HTML string to PDF document
var pdf = renderer.RenderHtmlAsPdf("<h1>Sales Report</h1><p>Generated on: " + DateTime.Now + "</p>");
// Save the resultant PDF document to a file
pdf.SaveAs("report.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这个代码片段创建了一个新的ChromePdfRenderer实例，它使用Chromium引擎来渲染您的HTML内容。 RenderHtmlAsPdf方法接受任何有效的HTML字符串并返回一个PdfDocument对象。 然后，您可以将此PDF文件保存到磁盘或直接以字节数组流传输给用户。 了解更多关于ChromePdfRenderer 类及其功能的信息。

输出

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 6 - PDF 输出

使用CSS和图像

IronPDF完全支持CSS样式，并且在将HTML转换为PDF时可以嵌入来自各种来源的图像。 PDF转换器以完整的忠实度处理HTML元素，包括各种HTML标签和图片URL：

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

渲染器处理内联样式，CSS文件，甚至base64编码的图像。 这确保您的PDF页面保持HTML内容的精确外观，包括现代CSS3功能如弹性盒子和网格布局。 HTML到PDF的转换保留了所有HTML标签及其样式，而不生成空白页面。

如何将ASP.NET Core视图转换为PDF？

将整个ASP.NET Core网页或视图转换为PDF是一项常见需求，尤其是基于现有HTML文档生成报告时。 IronPDF为这种ASP HTML到PDF转换场景提供了多种方法，无论您是处理单个页面还是多个页面。

转换控制器视图

在你的ASP.NET Core控制器中，您可以将视图渲染为HTML，然后使用IronPDF的强大 PDF 库渲染功能将其转换为PDF文档：

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}
[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这种方法首先将Razor视图渲染为HTML字符串，然后转换为PDF。 PDF以合适的文件名作为文件下载返回给用户的浏览器。 无论您是在转换ASPX文件还是现代Razor视图，这种方式都能无缝工作。

输出

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 7 - 控制器视图输出

将 URL 转换为 PDF

对于现有网页，您可以使用IronPDF作为强大的HTML到PDF转换工具，将任何指定的URL直接转换为PDF文件。 只需提供HTTP或HTTPS地址作为URL参数：

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}
[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此方法特别有用，当您已经有格式良好的网页并希望将其作为下载的PDF版本提供时。 .NET库处理所有外部资源，包括样式表、脚本和图像，确保完整的HTML渲染。 如果遇到无效的URL，转换器将返回适当的HTTP状态码。

输出

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 8 - URL 到 PDF 输出

处理身份验证

在使用.NET表单身份验证或其他安全机制转换身份认证页面时，您可以传递Cookie或头信息以保持相同用户账户会话。 这可以防止在PDF转换过程中重定向到登录界面：

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");
var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这确保了受保护的HTML内容可以在保持安全性的同时转换为PDF文件。 PDF转换过程尊重您的应用程序的基本身份验证和表单身份验证，防止未经授权的用户账户访问敏感的现有文档。 在需要时，您还可以在基本身份验证场景中传递用户名和密码参数。

如何自定义PDF输出？

IronPDF作为一个全面的PDF转换器，提供广泛的自定义选项，以控制从HTML文档生成的PDF文档。 这些设置帮助您创建满足页面布局和格式特定要求的专业PDF文件。

页面设置和边距

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这些设置控制PDF页面的物理布局，包括奇数页和偶数页。 您可以选择标准纸张尺寸或定义自定义尺寸，设置纵向或横向方向，并根据您的设计要求调整多个页面的边距。 图形模板系统确保后续的奇数页和偶数页的一致样式。

输出

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 9 - 自定义 PDF 输出

页眉和页脚

在将HTML文档转换为PDF时，添加一致的页眉和页脚增强了PDF文档的专业外观：

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

页眉和页脚支持HTML元素和格式，并在所有PDF页面上提供页码、日期和其他动态内容的特殊占位符。 下面的代码展示了如何为您动态生成的文档或现有PDF文档添加专业的页眉。

最佳实践是什么？

为了确保在HTML到PDF的转换中获得最佳的性能和质量，请遵循这些成功的PDF转换的有效实践。

始终首先在浏览器中测试您的HTML渲染，以验证样式和布局，然后再生成PDF文件。 尽可能使用绝对URL作为外部资源，因相对路径在HTML到PDF转换过程中可能导致问题。 对于复杂的 JavaScript 重的网页，具有多个 HTML 元素，添加渲染延迟以确保完全加载。 考虑对频繁生成的PDF文档进行缓存以减少服务器负载。 有关使用此 .NET 库的更多ASP.NET Core 最佳实践，请参阅Microsoft 的官方文档。

部署到生产环境时，配置适当的临时文件夹路径，确保托管环境安装了PDF库所需的依赖项，特别是对于Linux部署。 避免将脚本和转换逻辑放在同一目录中以防止冲突。 请查看我们的故障排除指南，了解现有 PDF 文档的常见部署场景。 如果您打算处理直接HTML内容，应始终验证输入不是URL，以避免意外行为。

结论

在ASP.NET Core应用程序中将ASP HTML转换为PDF变得简单得多使用IronPDF。 该库的基于Chrome的渲染确保准确的转换，同时提供了广泛的自定义选项以用于专业文档的生成。

无论是处理HTML字符串、URL还是整个网页，IronPDF都能保留精确的格式、CSS样式和JavaScript行为。 这个基于.NET的网络应用程序工具有效地处理整个PDF转换过程。

立即开始您的 30 天免费试用，在您的ASP.NET Core 应用程序中实现专业的 PDF 生成功能。 需要帮助选择？ 查看许可选项或与我们的团队预约演示。

如何在 .NET Core 中使用 IronPDF 将 ASP HTML 转换为 PDF：图 10 - 许可

常见问题解答

在 ASP.NET Core 中，将 HTML 转换为 PDF 的最佳方法是什么？

在 ASP.NET Core 中，将 HTML 转换为 PDF 的最佳方法是使用 IronPDF。它提供了一种无缝的 HTML 内容转换解决方案，确保生成高质量的 PDF 文件。

我为什么要使用 IronPDF 将 HTML 转换为 PDF？

IronPDF 提供强大的功能，例如精确渲染、支持 CSS 和 JavaScript，以及处理复杂 HTML 文档的能力。这使其成为从 ASP.NET 应用程序生成专业级 PDF 的理想选择。

IronPDF能否处理ASP.NET应用程序中的动态内容？

是的，IronPDF 可以有效地处理 ASP.NET 应用程序中的动态内容。它可以处理动态 HTML 内容并将其转换为 PDF，非常适合创建发票、报告和其他文档。

是否可以使用 IronPDF 将 CSS 样式添加到生成的 PDF 中？

当然，IronPDF 支持 CSS 样式。您可以应用现有的 CSS 样式表，以确保 PDF 输出与 HTML 内容的布局和设计保持一致。

IronPDF 如何在 HTML 转 PDF 过程中支持 JavaScript？

IronPDF 完全支持 JavaScript，允许您在 HTML 中包含动态元素和交互式内容，这些内容将在生成的 PDF 中准确呈现。

在 ASP.NET 中，将 HTML 转换为 PDF 有哪些常见用例？

常见用例包括生成发票、创建详细报告、生成证书，以及直接从 ASP.NET 应用程序提供可下载内容，如电子书和宣传册。

IronPDF 如何保证 PDF 输出的质量？

IronPDF 通过精确渲染 HTML 内容（包括字体、图像、表格和其他元素），确保高质量的 PDF 输出，并保持原始设计的完整性。

我可以使用 IronPDF 自动完成 HTML 到 PDF 的转换过程吗？

是的，IronPDF 可以集成到 ASP.NET 应用程序的自动化工作流程中，使您可以将 HTML 转换为 PDF 作为应用程序流程的一部分自动执行。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

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

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

相关文章

30天试用 → 完整产品。无限制。无卡。 免费试用