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

输出 PDF 文件

!a href="/static-assets/pdf/blog/convert-html-to-pdf-aspdotnet-csharp/convert-html-to-pdf-aspdotnet-csharp-1.webp">How to Convert HTML to PDF in ASP.NET using C# with IronPDF：图片 1 - 与如何使用 IronPDF for .NET 中的 C# 将 HTML 转换为 PDF 相关的 7 张图片中的 1 张。

添加图片 alt 文本

该代码创建了一个简单的控制器，可直接从 HTML 字符串生成 PDF 文档。 ChromePdfRenderer 类可处理所有复杂的渲染，确保您的 HTML 结构、CSS 样式甚至 JavaScript 都能在最终的 PDF 输出中正确呈现。

动态转换 HTML 字符串

在处理动态内容（如数据库驱动的报告）时，使用 RenderHtmlAsPdf 可轻松地直接转换 HTML 字符串：

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDF 输出

。

这种方法非常适合从填充了实时数据、表单提交或任何动态生成的 HTML 内容的 HTML 页面模板生成 PDF 文档。

从磁盘转换 HTML 文件

对于以文件形式存储的静态 HTML 模板，可使用 RenderHtmlFileAsPdf 直接转换 HTML 文件：

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

这种方法可以有效处理现有的 HTML 文件，自动解析 CSS 样式、图像和外部资源的相对 URL。

将 URL 转换为 PDF

要捕获整个网页或将现有 URL 转换为 PDF，请使用 URL 转换方法：

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
pdf.SaveAs("webpage.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

输出

!a href="/static-assets/pdf/blog/convert-html-to-pdf-aspdotnet-csharp/convert-html-to-pdf-aspdotnet-csharp-3.webp">How to Convert HTML to PDF in ASP.NET using C# with IronPDF：图片 3 - URL 至 PDF 输出。

该强大功能支持复杂的 JavaScript 渲染，是转换单页应用程序或从指定 URL 动态加载网页内容的理想选择。

视图示例

!a href="/static-assets/pdf/blog/convert-html-to-pdf-aspdotnet-csharp/convert-html-to-pdf-aspdotnet-csharp-4.webp">How to Convert HTML to PDF in ASP.NET using C# with IronPDF：图片 4 - 表单 UI 示例。

示例输出

!a href="/static-assets/pdf/blog/convert-html-to-pdf-aspdotnet-csharp/convert-html-to-pdf-aspdotnet-csharp-5.webp">How to Convert HTML to PDF in ASP.NET using C# with IronPDF：图片 5 - 从表单渲染的 PDF 输出示例。

添加页眉、页脚和水印

专业 PDF 文档通常需要页眉、页脚和水印。 IronPDF 强大的编辑功能让操作 PDF 文档变得易如反掌，因此可以直接添加这些内容。

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

水印输出

!a href="/static-assets/pdf/blog/convert-html-to-pdf-aspdotnet-csharp/convert-html-to-pdf-aspdotnet-csharp-6.webp">How to Convert HTML to PDF in ASP.NET using C# with IronPDF：图片 6 - 生成的 PDF 添加了水印和页眉/页脚。

这些功能将基本的 HTML 转换为 PDF 转变为专业的文档生成，是合同、报告和官方文件的完美选择。

优化 CSS 和印刷媒体

为确保 PDF 输出符合预期，请利用 CSS 打印媒体查询和响应式设计原则：

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDF 输出

使用打印 CSS 可确保您的 PDF 文档保持专业格式，同时隐藏不必要的网络元素，如导航菜单或交互式按钮。 可以使用 CSS 控制内分页符等功能，以确保在当前页面上呈现最佳效果。