使用 IRON SUITE

如何在 .NET 10 中将 HTML 转换为 PDF

已发布:

将网络内容转换为便携式文档格式（PDF）是现代.NET应用程序的常见需求。 无论您需要存档网页、生成发票还是提供可下载的报告，快速可靠地将HTML转换为PDF的能力至关重要。 IronPDF 是一个强大的.NET库，提供了强大的PDF转换功能，让开发人员可以直接将HTML、HTML字符串或整个网页转换为完全样式化的PDF文档，代码量很少。

本指南将带您了解在C#中进行HTML到PDF的转换，包括动态文档、自定义页眉和复杂的布局，同时演示如何使用IronPDF高效生成PDF。

为什么在C#中使用IronPDF进行HTML到PDF的转换

虽然有许多第三方库可用于HTML到PDF的转换，但IronPDF在.NET生态系统中因几个原因而脱颖而出：

  • 轻松将HTML文件、HTML字符串或HTML代码直接转换为PDF格式。

  • 编辑PDF文档、添加数字签名及以几行代码保存PDF文件。

  • 支持带有打印CSS的整个网页渲染、指定URL渲染，以及预期布局一致性。

  • 使用公共静态异步Task方法或同步API进行大规模PDF生成，适用于动态内容。

  • 在.NET Core、.NET Framework和最新C#版本下无缝工作。

  • 支持API集成、命令行以及商业许可使用场景。

入门：安装IronPDF

您可以通过NuGet包管理器安装IronPDF：

Install-Package IronPdf
Install-Package IronPdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf
$vbLabelText   $csharpLabel

安装完成后，您可以立即开始从HTML内容或网页创建PDF文档。

简单的HTML到PDF转换

以下是如何仅用几行代码将HTML转换为PDF的方法：

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Your HTML content
        string html = "<h1>Welcome to IronPDF</h1><p>This is a generated PDF document.</p>";

        // Convert HTML string to PDF
        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);

        // Save PDF
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF generated successfully!");
    }
}
using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        // Your HTML content
        string html = "<h1>Welcome to IronPDF</h1><p>This is a generated PDF document.</p>";

        // Convert HTML string to PDF
        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);

        // Save PDF
        pdf.SaveAs("output.pdf");

        Console.WriteLine("PDF generated successfully!");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

在第一个示例中，我们将一个简单的HTML字符串转换成PDF文档。 使用IronPdf; 行引入IronPDF库，使我们能使用其强大的HTML到PDF转换功能。 我们在字符串中定义HTML内容，它可以是简单的标题和段落，也可以是整个HTML代码页的复杂内容。

使用RenderHtmlAsPdf，IronPDF将HTML渲染为完整格式的PDF。 最后，SaveAs将PDF写到磁盘，我们打印确认信息。 这是一个很好的示例，展示如何仅用几行代码生成PDF，而不必担心Microsoft Office依赖问题。

HTML字符串到PDF示例输出

转换HTML文件或网页

IronPDF还可以让您将完整网页或本地HTML文件转换为PDF文档：

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Optional settings
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        renderer.RenderingOptions.WaitFor.RenderDelay(3000);

        var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        pdf.SaveAs("wikipedia.pdf");

    }
}
using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // Optional settings
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        renderer.RenderingOptions.WaitFor.RenderDelay(3000);

        var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");
        pdf.SaveAs("wikipedia.pdf");

    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此示例演示如何使用IronPDF的基于Chromium的渲染引擎将实时网页转换为PDF。 我们为动态内容启用JavaScript，应用打印CSS以确保正确布局，并添加简短渲染延迟以确保所有内容加载。 最后，页面被转换为高保真度PDF并保存为wikipedia.pdf。 这种方法非常适合存档网络内容或可靠快速地从复杂页面生成PDF。

URL到PDF输出示例

开发人员的高级功能

IronPDF为动态文档提供了广泛的PDF转换功能：

  • 自定义页眉和页脚

  • 适用于重复文档的自定义模板

  • 通过HTML字符串动态渲染内容

  • 存档法律或审计用途的网络内容

  • 数字签名符合便携式文档格式

  • 适用于批量操作的大规模PDF生成

示例：添加自定义页眉

var renderer = new ChromePdfRenderer();

// Optional settings
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    MaxHeight = 50,
    HtmlFragment = "<div style='width:100%; text-align:center; font-size:14px;'>Custom Header</div>",
    DrawDividerLine = true
};

var document = renderer.RenderHtmlAsPdf("<p>Dynamic HTML content</p>");
document.SaveAs("customHeader.pdf");
var renderer = new ChromePdfRenderer();

// Optional settings
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    MaxHeight = 50,
    HtmlFragment = "<div style='width:100%; text-align:center; font-size:14px;'>Custom Header</div>",
    DrawDividerLine = true
};

var document = renderer.RenderHtmlAsPdf("<p>Dynamic HTML content</p>");
document.SaveAs("customHeader.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

在许多情况下，您想要的不仅仅是PDF，您还希望它看起来专业。 在这里，我们使用HtmlHeaderFooter类为我们的PDF文档创建自定义页眉。 您可以利用此功能轻松地为PDF文档添加内容，如品牌、页码等。 所有这些都只需几行简单的代码。

带有自定义页眉的PDF示例

API集成和异步PDF生成

对于网络应用程序，您可以使用公共静态异步Task方法动态生成PDF：

public static async Task GeneratePdfAsync(string htmlContent)
 {
     var pdfDocument = await new ChromePdfRenderer().RenderHtmlAsPdfAsync(htmlContent);
     pdfDocument.SaveAs("async_output.pdf");
 }
public static async Task GeneratePdfAsync(string htmlContent)
 {
     var pdfDocument = await new ChromePdfRenderer().RenderHtmlAsPdfAsync(htmlContent);
     pdfDocument.SaveAs("async_output.pdf");
 }
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

高保真HTML到PDF转换的提示

  1. 始终包含打印CSS以确保生成PDF的预期布局。

  2. 使用动态HTML字符串即时生成报告或发票PDF。

  3. 利用IronPDF的渲染引擎处理包含表格、图像和表单的复杂布局。

  4. 在转换后操作PDF文档以添加元数据、数字签名或注释。

  5. 测试多个HTML页面的大规模PDF生成以验证性能和可靠性。

竞争对手：探索IronPDF的替代方案

虽然IronPDF是一个功能强大且功能丰富的解决方案用于在C#中进行HTML到PDF的转换，但根据项目需求，开发人员可以考虑一些替代方案。

一个显著的选择是QuestPDF，一个专注于从零开始创建PDF文档的开源库，采用流畅的、代码优先的方法。 虽然QuestPDF擅长生成动态、编程构建的PDF，但它不太适合转换复杂HTML内容或完整网页，特别是那些依赖JavaScript或高级CSS的。 这使得IronPDF在需要直接将HTML字符串、文件或实时网页转换为专业PDF时更为直接选择。

在.NET生态系统中的其他第三方库包括如SelectPdf、DinkToPdf和PuppeteerSharp等工具。SelectPdf和DinkToPdf提供HTML到PDF的转换功能，各自具备不同程度的CSS和JavaScript支持，而PuppeteerSharp使用无头Chromium引擎准确地渲染网页。 每个库在性能、渲染保真度、许可和API简单性方面都有其权衡。

对于C# HTML到PDF库及其IronPDF替代方案，包括功能详解、代码示例和使用案例的详细比较，请查看此文章：QuestPDF及其他HTML到PDF的替代品面向.NET开发人员。

结论

使用IronPDF，在C#中进行HTML到PDF的转换变得简单、可靠且灵活。 无论您是在转换HTML字符串、HTML文件还是完整的网页，IronPDF的强大方法让您只用最少的代码生成具有复杂布局、动态内容的PDF文档。

其.NET库集成、API支持和商业许可证选项使其成为开发人员在.NET Core或.NET Framework项目中实施PDF生成时的首选。

立即通过免费试用开始探索IronPDF并轻松将HTML内容转换为PDF。 通过NuGet包管理器下载最新版本，并用几行代码创建PDF文档。