Corriger l'erreur iTextSharp « Document sans pages » lors de la conversion HTML en PDF | IronPDF

Que s'affiche la console lorsque cette erreur se produit ?

Ce code tente de créer un fichier PDF à partir de HTML, mais rencontre une exception car XMLWorker n'a pas pu analyser correctement le contenu HTML. L'opération d'écriture s'achève, mais aucun contenu n'est ajouté au document, ce qui donne un fichier vide. Cet échec d'analyse est l'un des problèmes les plus courants rencontrés par les développeurs lors de la conversion de HTML en PDF dans les applications ASP.NET . Le problème se complexifie lorsqu'il s'agit de styles CSS personnalisés ou de contenu rendu en JavaScript.

À quoi ressemble le fichier PDF généré avec cette solution de contournement ?

Pourquoi certains éléments HTML complexes ne s'affichent-ils toujours pas ?

L'ajout d'un paragraphe vide empêche l'erreur immédiate, mais le code HTML complexe contenant des éléments de tableau, des images ou des polices personnalisées ne s'affiche souvent pas correctement. Le contenu du document PDF résultant peut être manquant ou malformé. Les développeurs rencontrent le même problème lors du traitement de code HTML contenant des styles intégrés, des éléments de lien hypertexte ou des propriétés de largeur spécifiques. Les références nulles et le rendu d'éléments manquants créent des problèmes supplémentaires qui nécessitent une résolution plus poussée.

XMLWorker a été conçu pour gérer un sous-ensemble de HTML 4 et de CSS 2 de base. Les pages Web modernes utilisent couramment des fonctionnalités bien au-delà de cette portée : CSS Grid, Flexbox, variables CSS, expressions calc(), graphiques SVG et rendu piloté par JavaScript. Chacun de ces éléments peut déclencher l'erreur " aucune page " ou produire une sortie corrompue sans message d'erreur explicite, ni autre message descriptif pour guider la correction.

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

    // Custom fonts -- 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");

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

' Common XMLWorker limitations that require manual handling
Public Sub ProcessComplexHTML(htmlContent As String)
    ' CSS flexbox -- not supported by XMLWorker
    If htmlContent.Contains("display: flex") Then
        Throw New NotSupportedException("Flexbox layout not supported")
    End If

    ' JavaScript content -- silently ignored
    If htmlContent.Contains("<script>") Then
        Console.WriteLine("Warning: JavaScript will be ignored")
    End If

    ' Custom fonts -- require manual embedding
    If htmlContent.Contains("@font-face") Then
        Console.WriteLine("Warning: Web fonts need manual setup")
    End If
End Sub

Que se passe-t-il lorsque iTextSharp traite cette facture ?

Lorsque iTextSharp traite ce modèle de facture, le résultat est souvent dépourvu de style CSS, les couleurs d'arrière-plan sont manquantes et les bordures de tableau disparaissent. La requête @media print est ignorée, et toute référence à une police Web provoque des erreurs d'analyse silencieuses. Si le code HTML contient une propriété CSS que XMLWorker ne reconnaît pas, le bloc entier risque de ne pas s'afficher, ce qui entraînera un contenu manquant sans qu'aucune erreur ne soit signalée lors de l'analyse.

Comment IronPDF génère-t-il la même facture ?

Pourquoi ces éléments HTML posent-ils problème dans iTextSharp ?

Avec XMLWorker d'iTextSharp, cette facture pourrait échouer en raison du style du tableau, des propriétés de largeur ou des spécifications de police. L'erreur " ce document ne comporte aucune page " apparaît souvent lorsque ces éléments ne sont pas pris en charge. Les hyperliens et les références de requêtes média peuvent également ne pas s'afficher correctement. Ces limitations deviennent critiques lors de la mise en œuvre de fonctionnalités PDF avancées telles que les signatures numériques ou la numérotation des pages dans les applications professionnelles.

Selon la documentation du Mozilla Developer Network sur CSS , le CSS moderne comprend des centaines de propriétés et de valeurs prises en charge nativement par les navigateurs. XMLWorker ne couvre qu'une petite partie de ces cas, ce qui explique pourquoi le contenu web réel provoque systématiquement des erreurs d'analyse.

Comment installer IronPDF via NuGet?

Avant d'écrire le moindre code, installez le package NuGet IronPDF . Vous pouvez le faire depuis l'interface de ligne de commande .NET :

dotnet add package IronPdf

dotnet add package IronPdf

Ou depuis la console du gestionnaire de packages NuGet dans Visual Studio :

Install-Package IronPdf

Install-Package IronPdf

Une fois installé, vous avez accès à ChromePdfRenderer, qui remplace l'ensemble du pipeline iTextSharp + XMLWorker par un seul appel fiable.

Comment convertir du HTML en PDF avec IronPDF?

L'exemple suivant génère le même code HTML de facture qui provoquait des erreurs dans iTextSharp. Notez qu'il n'y a pas de solution de contournement, pas de paragraphes vides à ajouter en début de document, ni d'erreurs silencieuses à gérer :

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

Imports IronPdf

Dim renderer As 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

Dim html As String = "<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>"

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

À quoi ressemble le résultat IronPDF ?

Pourquoi cette approche élimine-t-elle les erreurs d'analyse syntaxique ?

Ce code crée avec succès le fichier PDF sans aucune exception. La méthode traite automatiquement les fichiers HTML et CSS complexes, éliminant ainsi la nécessité de recourir à des solutions de contournement. Le contenu est rendu au pixel près, correspondant à la prévisualisation du navigateur. IronPDF prend également en charge le rendu asynchrone , les marges personnalisées et la compression PDF pour des fichiers de taille optimisée.

Pour les scénarios impliquant un contenu riche en JavaScript ou des applications monopages, l'option RenderDelay d'IronPDF permet l'exécution du JavaScript avant la capture du PDF, chose que XMLWorker ne peut pas faire du tout. L'exemple suivant ajoute des en-têtes, des pieds de page et des paramètres de sécurité selon un modèle asynchrone prêt pour la production :

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

Imports IronPdf
Imports Microsoft.Extensions.Logging

' Production-ready PDF generation with IronPDF
Public Class PdfGenerator
    Private ReadOnly _renderer As ChromePdfRenderer
    Private ReadOnly _logger As ILogger(Of PdfGenerator)

    Public Sub New(logger As ILogger(Of PdfGenerator))
        _logger = logger
        _renderer = New ChromePdfRenderer()
        _renderer.RenderingOptions.Timeout = 60
        _renderer.RenderingOptions.EnableJavaScript = True
        _renderer.RenderingOptions.RenderDelay = 2000
        _renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
            .Height = 25,
            .HtmlFragment = "<div style='text-align: center;'>{page} of {total-pages}</div>"
        }
    End Sub

    Public Async Function GenerateWithRetry(html As String, Optional maxRetries As Integer = 3) As Task(Of PdfDocument)
        For i As Integer = 0 To maxRetries - 1
            Try
                _logger.LogInformation("Generating PDF, attempt {Attempt}", i + 1)
                Return Await _renderer.RenderHtmlAsPdfAsync(html)
            Catch ex As Exception
                _logger.LogWarning("PDF generation failed: {Message}", ex.Message)
                If i = maxRetries - 1 Then Throw
                Await Task.Delay(1000 * (i + 1))
            End Try
        Next
        Throw New InvalidOperationException("PDF generation failed after retries")
    End Function
End Class

Comment migrer d'iTextSharp vers IronPDF?

Pour les développeurs qui rencontrent l'erreur "le document n'a pas de pages", la migration vers IronPDF offre une solution immédiate. Le processus de conversion est simple et IronPDF propose une documentation complète ainsi que des exemples de code . La comparaison avant-après suivante illustre la réduction de la complexité :

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

Imports System.IO
Imports iTextSharp.text
Imports iTextSharp.text.pdf
Imports iTextSharp.tool.xml

Public Class PdfCreator

    ' Before (iTextSharp) -- error-prone approach requiring workarounds
    Public Function CreatePdfWithIText(htmlContent As String) As Byte()
        Using ms As New MemoryStream()
            Dim document As New Document()
            Dim writer As PdfWriter = PdfWriter.GetInstance(document, ms)
            document.Open()

            ' Must add empty paragraph to avoid "no pages" error
            document.Add(New Paragraph(""))

            Try
                Using sr As New StringReader(htmlContent)
                    XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, sr)
                End Using
            Catch ex As Exception
                document.Add(New Paragraph("Error: " & ex.Message))
            End Try

            document.Close()
            Return ms.ToArray()
        End Using
    End Function

    ' After (IronPDF) -- reliable, no workarounds needed
    Public Function CreatePdfWithIron(htmlContent As String) As Byte()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.EnableJavaScript = True
        renderer.RenderingOptions.RenderDelay = 500

        Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
        Return pdf.BinaryData
    End Function

End Class

Qu'est-ce qui rend l'API d'IronPDF plus conviviale pour les développeurs ?

L'API simplifiée signifie moins de code à maintenir et pas d'erreurs d'analyse à déboguer. IronPDF offre également des fonctionnalités permettant d' ajouter des en-têtes et des pieds de page , de fusionner des PDF et d'appliquer des signatures numériques sans solutions de contournement complexes. Pour les équipes travaillant dans des environnements Docker ou déployant sur des serveurs Linux, IronPDF offre un comportement cohérent sur toutes les plateformes.

Installer avec NuGet

PM >  Install-Package IronPdf

Consultez IronPDF sur NuGet pour une installation rapide. Avec plus de 10 millions de téléchargements, il transforme le développement PDF avec C#. Vous pouvez également télécharger le DLL ou l'installateur Windows.

Démarrez votre essai gratuit pour bénéficier d'une conversion HTML vers PDF sans erreur.