Corrija el error "El documento no tiene páginas" de iTextSharp en la conversión de HTML a PDF | IronPDF

¿Qué muestra la salida de la consola cuando ocurre este error?

Este código intenta crear un archivo PDF a partir de HTML, pero encuentra la excepción porque XMLWorker no pudo analizar el contenido HTML correctamente. La operación de escritura se completa, pero no se añade contenido al documento, lo que resulta en un archivo vacío. Este error de análisis es uno de los problemas más comunes que enfrentan los desarrolladores al trabajar con la conversión de HTML a PDF en aplicaciones ASP.NET . La cuestión se vuelve más compleja cuando se trata de estilos CSS personalizados o contenido renderizado en JavaScript.

¿Cómo se ve la salida PDF con esta solución alternativa?

¿Por qué los elementos HTML complejos aún no se pueden representar?

Agregar un párrafo vacío evita el error inmediato, pero el HTML complejo con elementos de tabla, imágenes o fuentes personalizadas a menudo no se procesa correctamente. Es posible que el contenido falte o esté mal formado en el documento PDF resultante. Los desarrolladores encuentran el mismo problema al procesar HTML con estilos incrustados, elementos de hipervínculo o propiedades de ancho específicas. Las referencias nulas y la representación de elementos faltantes crean problemas adicionales que requieren una mayor resolución.

XMLWorker fue diseñado para manejar un subconjunto de HTML 4 y CSS 2 básico. Las páginas web modernas usan rutinariamente características mucho más allá de este alcance: CSS Grid, Flexbox, variables CSS, calc() expresiones, gráficos SVG y renderización impulsada por JavaScript. Cualquiera de estos puede provocar el error "no hay páginas" o producir una salida defectuosa de manera silenciosa y sin ningún mensaje de error descriptivo que guíe la solución.

// 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 NotSupportedException("Flexbox layout not supported");

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

    // Fuentes personalizadas -- 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 NotSupportedException("Flexbox layout not supported");

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

    // Fuentes personalizadas -- require manual embedding
    if (htmlContent.Contains("@font-face"))
        Console.WriteLine("Warning: Web fonts need manual setup");
}

¿Qué sucede cuando iTextSharp procesa esta factura?

Cuando iTextSharp procesa esta plantilla de factura, la salida a menudo carece de estilo CSS, faltan colores de fondo y se pierden los bordes de las tablas. La consulta @media print se ignora, y cualquier referencia a fuentes web causa fallos silenciosos de análisis. Si el HTML contiene una propiedad CSS que XMLWorker no reconoce, es posible que no se pueda representar todo el bloque, lo que provocará que falte contenido sin que se produzca ningún error en el momento del análisis.

¿Cómo genera IronPDF la misma factura?

¿Por qué estos elementos HTML causan problemas en iTextSharp?

Con XMLWorker de iTextSharp, esta factura podría fallar debido al estilo de la tabla, las propiedades de ancho o las especificaciones de fuente. El error "el documento no tiene páginas" a menudo aparece cuando estos elementos no son compatibles. Es posible que los hipervínculos y las referencias de consultas de medios tampoco se representen correctamente. Estas limitaciones se vuelven críticas al implementar funciones PDF avanzadas como firmas digitales o números de página en aplicaciones comerciales.

Según la documentación de Mozilla Developer Network sobre CSS , el CSS moderno incluye cientos de propiedades y valores que los navegadores admiten de forma nativa. XMLWorker cubre solo una pequeña fracción de estos, por lo que el contenido web del mundo real constantemente genera errores de análisis.

¿Cómo instalar IronPDF a través de NuGet?

Antes de escribir cualquier código, instale el paquete NuGet IronPDF . Puedes hacer esto desde la CLI de .NET :

dotnet add package IronPdf

dotnet add package IronPdf

O desde la consola del Administrador de paquetes NuGet en Visual Studio:

Install-Package IronPdf

Install-Package IronPdf

Una vez instalado, tienes acceso a ChromePdfRenderer, que reemplaza toda la canalización de iTextSharp + Trabajador XML con una sola llamada confiable.

¿Cómo renderizar HTML a PDF con IronPDF?

El siguiente ejemplo muestra el mismo HTML de factura que causó errores en iTextSharp. Observe que no hay soluciones alternativas, ni párrafos vacíos que anteponer, ni errores silenciosos que gestionar:

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");

¿Cómo se ve la salida de IronPDF ?

¿Por qué este enfoque elimina los errores de análisis?

Este código crea correctamente el archivo PDF sin ninguna excepción. El método maneja HTML y CSS complejos de forma automática, eliminando la necesidad de recurrir a métodos alternativos. El contenido debe reproducirse perfectamente, como en la vista previa del navegador. IronPDF también admite renderizado asincrónico , márgenes personalizados y compresión de PDF para tamaños de archivos optimizados.

Para escenarios que involucran contenido pesado en JavaScript o aplicaciones de una sola página, la opción RenderDelay de IronPDF permite que el JavaScript se ejecute antes de que se capture el PDF, algo que XMLWorker no puede hacer en absoluto. El siguiente ejemplo agrega encabezados, pies de página y configuraciones de seguridad en un patrón asincrónico listo para producción:

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");
    }
}

¿Cómo migrar de iTextSharp a IronPDF?

Para los desarrolladores que experimentan el error "el documento no tiene páginas", la migración a IronPDF ofrece una solución inmediata. El proceso de conversión es directo, y IronPDF ofrece completa documentación y ejemplos de código. La siguiente comparación antes y después muestra la reducción de la complejidad:

// 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;
}

¿Qué hace que la API de IronPDF sea más amigable para los desarrolladores?

La API simplificada significa menos código que mantener y ningún error de análisis que depurar. IronPDF también ofrece funciones para agregar encabezados y pies de página , fusionar archivos PDF y aplicar firmas digitales sin soluciones alternativas complejas. Para los equipos que trabajan en entornos Docker o que implementan en servidores Linux, IronPDF ofrece un comportamiento consistente en todas las plataformas.

Instalar con NuGet

PM >  Install-Package IronPdf

Echa un vistazo a IronPDF en NuGet para una instalación rápida. Con más de 10 millones de descargas, está transformando el desarrollo de PDF con C#. También puede descargar el DLL o el instalador de Windows.

Comience su prueba gratuita para experimentar la conversión de HTML a PDF sin errores.