修复iTextSharp在HTML到PDF转换中的“文档无页”错误 | IronPDF

发生此错误时，控制台输出显示什么？

这段代码尝试从 HTML 创建 PDF 文件，但由于 XMLWorker 无法成功解析 HTML 内容而遇到异常。 写入操作已完成，但文档中未添加任何内容，导致生成一个空文件。这种解析失败是开发人员在ASP.NET应用程序中进行 HTML 转 PDF 转换时最常遇到的问题之一。 当处理自定义 CSS 样式或 JavaScript 渲染的内容时，问题会变得更加复杂。

使用此方法后，PDF 输出结果会是什么样子？

为什么复杂的HTML元素仍然无法渲染？

添加一个空段落可以防止立即出现错误，但包含表格元素、图像或自定义字体的复杂 HTML 经常无法正确渲染。 生成的PDF文档中可能缺少内容或格式错误。 开发人员在处理带有嵌入式样式、超链接元素或特定宽度属性的 HTML 时会遇到同样的问题。 空引用和缺失元素渲染会引发其他问题，需要进一步解决。

XMLWorker 的设计初衷是处理 HTML 4 和基本 CSS 2 的一个子集。现代网页经常使用远超此范围的功能：CSS Grid、Flexbox、CSS 变量、表达式、SVG 图形和 JavaScript 驱动的渲染。 这些情况中的任何一个都可能触发"无页面"错误或静默地产生损坏的输出——而且没有任何描述性的错误消息来指导修复。

// Common XMLWorker limitations that require manual handling
public void ProcessComplexHTML(string htmlContent)
{
    // CSS flexbox -- not supported by XMLWorker
    if (htmlContent.Contains("display: flex"))
        throw new 无tSupportedException("Flexbox layout not supported");

    // JavaScript content -- silently ignored
    if (htmlContent.Contains("<script>"))
        Console.WriteLine("Warning: JavaScript will be ignored");

    // 自定义字体 -- require manual embedding
    if (htmlContent.Contains("@font-face"))
        Console.WriteLine("Warning: Web fonts need manual setup");
}

// Common XMLWorker limitations that require manual handling
public void ProcessComplexHTML(string htmlContent)
{
    // CSS flexbox -- not supported by XMLWorker
    if (htmlContent.Contains("display: flex"))
        throw new 无tSupportedException("Flexbox layout not supported");

    // JavaScript content -- silently ignored
    if (htmlContent.Contains("<script>"))
        Console.WriteLine("Warning: JavaScript will be ignored");

    // 自定义字体 -- require manual embedding
    if (htmlContent.Contains("@font-face"))
        Console.WriteLine("Warning: Web fonts need manual setup");
}

iTextSharp 处理此发票时会发生什么？

当 iTextSharp 处理此发票模板时，输出结果通常会丢失 CSS 样式、背景颜色和表格边框。 查询 @media print 将被忽略，任何 Web 字体引用都会导致静默解析失败。 如果 HTML 中包含 XMLWorker 无法识别的 CSS 属性，则整个块可能无法渲染——导致内容缺失，且在解析时不会抛出任何错误。

IronPDF如何渲染同一张发票？

为什么这些 HTML 元素会导致 iTextSharp 出现问题？

使用 iTextSharp 的 XMLWorker 时，由于表格样式、宽度属性或字体规范的原因，此发票可能会失败。 当不支持这些元素时，通常会出现"文档没有页面"错误。 超链接和媒体查询引用也可能无法正确呈现。 在商业应用中实现数字签名或页码等高级 PDF 功能时，这些限制就显得至关重要了。

根据Mozilla 开发者网络关于 CSS 的文档，现代 CSS 包含数百个浏览器原生支持的属性和值。 XMLWorker 仅涵盖其中的一小部分，这就是为什么现实世界的 Web 内容经常触发解析失败的原因。

如何通过NuGet安装IronPDF ？

在编写任何代码之前，请先安装IronPDF NuGet包。 您可以通过.NET CLI 执行此操作：

dotnet add package IronPdf

dotnet add package IronPdf

或者从 Visual Studio 中的NuGet程序包管理器控制台：

Install-Package IronPdf

Install-Package IronPdf

安装完成后，您就可以使用 ChromePdfRenderer，它将整个 iTextSharp + XMLWorker 管道替换为一个可靠的调用。

如何使用IronPDF将 HTML 渲染成 PDF？

以下示例渲染了与 iTextSharp 中导致故障的相同发票 HTML 代码。请注意，这里没有任何变通方法，无需在代码开头添加空段落，也无需处理任何静默故障：

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options for production use
renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginBottom = 40;
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

string html = @"<div style='font-family: Arial; width: 100%;'>
    <h1 style='color: #2e6c80;'>Invoice #12345</h1>
    <table style='width: 100%; border-collapse: collapse;'>
        <tr>
            <th style='border: 1px solid #ddd; padding: 8px;'>Item</th>
            <th style='border: 1px solid #ddd; padding: 8px;'>Price</th>
        </tr>
        <tr>
            <td style='border: 1px solid #ddd; padding: 8px;'>Service</td>
            <td style='border: 1px solid #ddd; padding: 8px;'>$100.00</td>
        </tr>
    </table>
</div>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options for production use
renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginBottom = 40;
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

string html = @"<div style='font-family: Arial; width: 100%;'>
    <h1 style='color: #2e6c80;'>Invoice #12345</h1>
    <table style='width: 100%; border-collapse: collapse;'>
        <tr>
            <th style='border: 1px solid #ddd; padding: 8px;'>Item</th>
            <th style='border: 1px solid #ddd; padding: 8px;'>Price</th>
        </tr>
        <tr>
            <td style='border: 1px solid #ddd; padding: 8px;'>Service</td>
            <td style='border: 1px solid #ddd; padding: 8px;'>$100.00</td>
        </tr>
    </table>
</div>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("invoice.pdf");

IronPDF 的输出结果是什么样的？

为什么这种方法可以消除解析错误？

该代码无一例外地成功创建了 PDF 文件。 该方法可自动处理复杂的 HTML 和 CSS，无需使用变通方法。 内容渲染像素完美，与浏览器预览相匹配。 IronPDF还支持异步渲染、自定义边距和 PDF 压缩，以优化文件大小。

对于涉及大量 JavaScript 内容或单页应用程序的场景，IronPDF 的 RenderDelay 选项允许在捕获 PDF 之前执行JavaScript这是 XMLWorker 完全无法做到的。 以下示例以可用于生产环境的异步模式添加页眉、页脚和安全设置：

using IronPdf;
using Microsoft.Extensions.Logging;

// Production-ready PDF generation with IronPDF
public class PdfGenerator
{
    private readonly ChromePdfRenderer _renderer;
    private readonly ILogger<PdfGenerator> _logger;

    public PdfGenerator(ILogger<PdfGenerator> logger)
    {
        _logger = logger;
        _renderer = new ChromePdfRenderer();
        _renderer.RenderingOptions.Timeout = 60;
        _renderer.RenderingOptions.EnableJavaScript = true;
        _renderer.RenderingOptions.RenderDelay = 2000;
        _renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
        {
            Height = 25,
            HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>"
        };
    }

    public async Task<PdfDocument> GenerateWithRetry(string html, int maxRetries = 3)
    {
        for (int i = 0; i < maxRetries; i++)
        {
            try
            {
                _logger.LogInformation("Generating PDF, attempt {Attempt}", i + 1);
                return await _renderer.RenderHtmlAsPdfAsync(html);
            }
            catch (Exception ex)
            {
                _logger.LogWarning("PDF generation failed: {Message}", ex.Message);
                if (i == maxRetries - 1) throw;
                await Task.Delay(1000 * (i + 1));
            }
        }
        throw new InvalidOperationException("PDF generation failed after retries");
    }
}

using IronPdf;
using Microsoft.Extensions.Logging;

// Production-ready PDF generation with IronPDF
public class PdfGenerator
{
    private readonly ChromePdfRenderer _renderer;
    private readonly ILogger<PdfGenerator> _logger;

    public PdfGenerator(ILogger<PdfGenerator> logger)
    {
        _logger = logger;
        _renderer = new ChromePdfRenderer();
        _renderer.RenderingOptions.Timeout = 60;
        _renderer.RenderingOptions.EnableJavaScript = true;
        _renderer.RenderingOptions.RenderDelay = 2000;
        _renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
        {
            Height = 25,
            HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>"
        };
    }

    public async Task<PdfDocument> GenerateWithRetry(string html, int maxRetries = 3)
    {
        for (int i = 0; i < maxRetries; i++)
        {
            try
            {
                _logger.LogInformation("Generating PDF, attempt {Attempt}", i + 1);
                return await _renderer.RenderHtmlAsPdfAsync(html);
            }
            catch (Exception ex)
            {
                _logger.LogWarning("PDF generation failed: {Message}", ex.Message);
                if (i == maxRetries - 1) throw;
                await Task.Delay(1000 * (i + 1));
            }
        }
        throw new InvalidOperationException("PDF generation failed after retries");
    }
}

如何从 iTextSharp 迁移到IronPDF？

对于遇到 "文档无页面 "错误的开发人员来说，迁移到 IronPDF 可提供直接的解决方案。 转换过程很简单， IronPDF提供了完整的文档和代码示例。 以下对比图显示了复杂度的降低：

// Before (iTextSharp) -- error-prone approach requiring workarounds
public byte[] CreatePdfWithIText(string htmlContent)
{
    using var ms = new MemoryStream();
    var document = new Document();
    var writer = PdfWriter.GetInstance(document, ms);
    document.Open();

    // Must add empty paragraph to avoid "no pages" error
    document.Add(new Paragraph(""));

    try
    {
        using var sr = new StringReader(htmlContent);
        XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, sr);
    }
    catch (Exception ex)
    {
        document.Add(new Paragraph("Error: " + ex.Message));
    }

    document.Close();
    return ms.ToArray();
}

// After (IronPDF) -- reliable, no workarounds needed
public byte[] CreatePdfWithIron(string htmlContent)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.EnableJavaScript = true;
    renderer.RenderingOptions.RenderDelay = 500;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
    return pdf.BinaryData;
}

// Before (iTextSharp) -- error-prone approach requiring workarounds
public byte[] CreatePdfWithIText(string htmlContent)
{
    using var ms = new MemoryStream();
    var document = new Document();
    var writer = PdfWriter.GetInstance(document, ms);
    document.Open();

    // Must add empty paragraph to avoid "no pages" error
    document.Add(new Paragraph(""));

    try
    {
        using var sr = new StringReader(htmlContent);
        XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, sr);
    }
    catch (Exception ex)
    {
        document.Add(new Paragraph("Error: " + ex.Message));
    }

    document.Close();
    return ms.ToArray();
}

// After (IronPDF) -- reliable, no workarounds needed
public byte[] CreatePdfWithIron(string htmlContent)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    renderer.RenderingOptions.EnableJavaScript = true;
    renderer.RenderingOptions.RenderDelay = 500;

    PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
    return pdf.BinaryData;
}

IronPDF 的 API 有哪些方面对开发者更友好？

简化的 API 意味着需要维护的代码更少，而且无需调试解析错误。 IronPDF还提供添加页眉和页脚、合并 PDF以及应用数字签名等功能，无需复杂的变通方法。 对于在Docker 环境中工作或部署到 Linux 服务器的团队而言， IronPDF可在各个平台上提供一致的行为。

使用 NuGet 安装

PM >  Install-Package IronPdf

在 IronPDF 上查看 NuGet 快速安装。超过 1000 万次下载，它正以 C# 改变 PDF 开发。 您也可以下载 DLL 或 Windows 安装程序。

立即开始免费试用，体验无误的HTML 转 PDF 转换。