HTML 到 PDF 转换

将 HTML 内容转换为 PDF 演示了 API 的基本差异。

BCL EasyPDF SDK：

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf = new PDFDocument();
        var htmlConverter = new HTMLConverter();
        htmlConverter.ConvertHTML("<h1>Hello World</h1>", pdf);
        pdf.Save("output.pdf");
        pdf.Close();
    }
}

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf = new PDFDocument();
        var htmlConverter = new HTMLConverter();
        htmlConverter.ConvertHTML("<h1>Hello World</h1>", pdf);
        pdf.Save("output.pdf");
        pdf.Close();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        pdf.SaveAs("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

BCL EasyPDF SDK 需要创建一个 PDFDocument, 实例化一个单独的 HTMLConverter, 调用 ConvertHTML() 来填充文档，然后保存并明确关闭。IronPDF将其整合为创建 ChromePdfRenderer, 调用 RenderHtmlAsPdf(), 然后保存--无需明确关闭，因为 PdfDocument 实现了 IDisposable.

有关高级 HTML 渲染选项，请浏览 HTML 到 PDF 转换指南。

URL到PDF转换

将网页截取为 PDF 文档也显示出类似的模式差异。

BCL EasyPDF SDK：

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf = new PDFDocument();
        var htmlConverter = new HTMLConverter();
        htmlConverter.ConvertURL("https://example.com", pdf);
        pdf.Save("webpage.pdf");
        pdf.Close();
    }
}

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf = new PDFDocument();
        var htmlConverter = new HTMLConverter();
        htmlConverter.ConvertURL("https://example.com", pdf);
        pdf.Save("webpage.pdf");
        pdf.Close();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

BCL EasyPDF SDK 使用与 HTMLConverter.ConvertURL() 相同的多步骤模式。IronPDF的RenderUrlAsPdf()直接返回一个PdfDocument以供保存，使用 Chromium 引擎实现对 CSS3 和 JavaScript 的全面支持。

在 URL to PDF 文档中了解有关 URL 呈现的更多信息。

PDF 合并操作

结合多个 PDF 文档演示不同的 API 方法。

BCL EasyPDF SDK：

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf1 = new PDFDocument("document1.pdf");
        var pdf2 = new PDFDocument("document2.pdf");
        pdf1.Append(pdf2);
        pdf1.Save("merged.pdf");
        pdf1.Close();
        pdf2.Close();
    }
}

// NuGet: Install-Package BCL.EasyPDF
using BCL.EasyPDF;
using System;

class Program
{
    static void Main()
    {
        var pdf1 = new PDFDocument("document1.pdf");
        var pdf2 = new PDFDocument("document2.pdf");
        pdf1.Append(pdf2);
        pdf1.Save("merged.pdf");
        pdf1.Close();
        pdf2.Close();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

BCL EasyPDF SDK 使用 Append() 就地修改第一个文档，需要对两个文档都调用显式 Close() 。IronPDF使用静态 PdfDocument.Merge() 方法，该方法使用标准 .NET 集合模式，接受一个集合并返回一个新的合并文档。

在 IronPDF合并文档中探索其他合并操作。

核心业务

配置选项

注意超时差异：BCL EasyPDF SDK 使用秒，而IronPDF使用毫秒。

页面索引差异

在页面索引方面存在关键差异：

平台支持

BCL EasyPDF SDK 仅支持 Windows，不支持 Linux、macOS 或容器环境：

// BCL EasyPDF SDK: Windows-only, requires interactive session
Printer printer = new Printer();
// Error on Linux: Cannot find printer driver
// Error in Docker: Interactive session required

// BCL EasyPDF SDK: Windows-only, requires interactive session
Printer printer = new Printer();
// Error on Linux: Cannot find printer driver
// Error in Docker: Interactive session required

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPdf 可跨平台运行：

// IronPDF: Works on Windows, Linux, macOS, Docker
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// 否 printer drivers, no Office, no interactive session needed

// IronPDF: Works on Windows, Linux, macOS, Docker
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// 否 printer drivers, no Office, no interactive session needed

IRON VB CONVERTER ERROR developers@ironsoftware.com

安装和依赖性

BCL EasyPDF SDK 需要复杂的安装：

• MSI 安装程序
• 虚拟打印机驱动程序安装
• COM 互操作注册
• 安装 Microsoft Office 进行文档转换
• GAC 注册

IronPdf 使用一个 NuGet 包：

# BCL EasyPDF SDK: 否 NuGet package
# Uninstall via Programs and Features or remove DLL references

# IronPDF: Simple NuGet installation
dotnet add package IronPdf

# BCL EasyPDF SDK: 否 NuGet package
# Uninstall via Programs and Features or remove DLL references

# IronPDF: Simple NuGet installation
dotnet add package IronPdf

服务器部署

BCL EasyPDF SDK 需要交互式 Windows 会话，这会在服务器环境中造成问题：

// BCL EasyPDF SDK: May hang or fail on server
printer.Configuration.TimeOut = 120;
try
{
    printer.RenderHTMLToPDF("<h1>Report</h1>", "report.pdf");
}
catch (Exception ex)
{
    // Common errors: printer not found, timeout, session errors
    Console.WriteLine($"Error: {ex.Message}");
}

// BCL EasyPDF SDK: May hang or fail on server
printer.Configuration.TimeOut = 120;
try
{
    printer.RenderHTMLToPDF("<h1>Report</h1>", "report.pdf");
}
catch (Exception ex)
{
    // Common errors: printer not found, timeout, session errors
    Console.WriteLine($"Error: {ex.Message}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPdf 无头运行：

// IronPDF: Works reliably on servers
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.Timeout = 120000;
var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");
pdf.SaveAs("report.pdf");
// 否 printer drivers, no Office, no interactive session!

// IronPDF: Works reliably on servers
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.Timeout = 120000;
var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");
pdf.SaveAs("report.pdf");
// 否 printer drivers, no Office, no interactive session!

IRON VB CONVERTER ERROR developers@ironsoftware.com

BCL EasyPDF SDK的优势

• 熟悉的工具：利用 Microsoft Office 格式化功能
• 既定方法：虚拟打印机方法，在桌面应用程序方面拥有良好的记录
• 文档格式支持：支持打印机驱动程序支持的格式
• 办公集成：与 Microsoft 生态系统深度集成

BCL EasyPDF SDK注意事项

• 仅限 Windows：不支持 Linux、macOS 或容器
• 需要使用 Office：必须在每台服务器上安装 Office
• 复杂安装：MSI 安装程序、COM 互操作、GAC 注册
• 服务器挑战：需要交互会话，经常出现超时和 "拒绝访问 "错误
• Legacy 依赖性：COM 互操作会导致 DLL 加载错误和版本冲突
• Limited .NET Core：与现代 .NET 环境的斗争

IronPDF的优势

• 跨平台：Windows、Linux、macOS、Docker、Kubernetes
• 无依赖性：无需安装 Office 或打印机驱动程序
• 简单安装：单个 NuGet 软件包
• 服务器就绪：无头运行，无需交互会话
• Modern .NET：完全支持 .NET 5/6/7/8/9
• Chromium 引擎：完全支持 CSS3、JavaScript、Flexbox 和网格
• 本地异步：现代异步/等待模式
• 丰富的资源：全面的教程和文档。