Beheben Sie den iTextSharp-Fehler 'Dokument hat keine Seiten' in HTML-zu-PDF-Konvertierung | IronPDF

Was zeigt die Konsolenausgabe an, wenn dieser Fehler auftritt?

Dieser Code versucht, aus HTML eine PDF-Datei zu erstellen, stößt aber auf eine Ausnahme, da XMLWorker den HTML-Inhalt nicht erfolgreich parsen konnte. Der Schreibvorgang wird zwar abgeschlossen, aber es werden keine Inhalte in das Dokument eingefügt, sodass die Datei leer bleibt. Dieser Analysefehler ist eines der häufigsten Probleme, mit denen Entwickler bei der HTML-zu-PDF-Konvertierung in ASP.NET -Anwendungen konfrontiert werden. Das Problem wird noch komplexer, wenn es um benutzerdefinierte CSS-Stile oder JavaScript-gerenderte Inhalte geht.

Wie sieht die PDF-Ausgabe mit diesem Workaround aus?

Warum werden komplexe HTML-Elemente immer noch nicht korrekt dargestellt?

Das Einfügen eines leeren Absatzes verhindert zwar den unmittelbaren Fehler, aber komplexes HTML mit Tabellenelementen, Bildern oder benutzerdefinierten Schriftarten wird oft nicht korrekt dargestellt. Im resultierenden PDF-Dokument kann der Inhalt fehlen oder fehlerhaft sein. Entwickler stoßen auf dasselbe Problem bei der Verarbeitung von HTML mit eingebetteten Stilen, Hyperlink-Elementen oder spezifischen Breiteneigenschaften. Nullreferenzen und fehlende Elementdarstellung erzeugen zusätzliche Probleme, die einer weiteren Lösung bedürfen.

XMLWorker wurde für die Verarbeitung einer Teilmenge von HTML 4 und grundlegendem CSS 2 entwickelt. Moderne Webseiten nutzen routinemäßig Funktionen, die weit über diesen Rahmen hinausgehen: CSS Grid, Flexbox, CSS-Variablen, calc()-Ausdrücke, SVG-Grafiken und JavaScript-gesteuertes Rendering. Jeder dieser Faktoren kann den Fehler "Keine Seiten" auslösen oder stillschweigend fehlerhafte Ausgaben erzeugen – und zwar ohne beschreibende Fehlermeldung, die zur Behebung des Problems auffordert.

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

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

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

Public Sub ProcessComplexHTML(ByVal 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

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

Was geschieht, wenn iTextSharp diese Rechnung verarbeitet?

Bei der Verarbeitung dieser Rechnungsvorlage durch iTextSharp kommt es häufig vor, dass die Ausgabe ohne CSS-Formatierung, Hintergrundfarben und Tabellenrahmen auskommt. Die Abfrage @media print wird ignoriert, und alle Verweise auf Webfonts führen zu stillen Parsing-Fehlern. Wenn der HTML-Code eine CSS-Eigenschaft enthält, die XMLWorker nicht erkennt, kann der gesamte Block möglicherweise nicht gerendert werden – was dazu führt, dass Inhalte fehlen, ohne dass beim Parsen ein Fehler ausgelöst wird.

Wie rendert IronPDF dieselbe Rechnung?

Warum verursachen diese HTML-Elemente Probleme in iTextSharp?

Bei Verwendung des XMLWorkers von iTextSharp kann diese Rechnung aufgrund von Tabellenformatierungen, Breiteneigenschaften oder Schriftartspezifikationen fehlschlagen. Der Fehler "Das Dokument hat keine Seiten" tritt häufig auf, wenn diese Elemente nicht unterstützt werden. Hyperlinks und Media-Query-Referenzen werden möglicherweise ebenfalls nicht korrekt dargestellt. Diese Einschränkungen werden kritisch, wenn fortgeschrittene PDF-Funktionen wie digitale Signaturen oder Seitenzahlen in Geschäftsanwendungen implementiert werden.

Laut der Dokumentation des Mozilla Developer Network zu CSS umfasst modernes CSS Hunderte von Eigenschaften und Werten, die von Browsern nativ unterstützt werden. XMLWorker deckt nur einen kleinen Teil davon ab, weshalb reale Webinhalte immer wieder zu Parsing-Fehlern führen.

Wie installiert man IronPDF über NuGet?

Bevor Sie mit dem Schreiben von Code beginnen, installieren Sie das IronPDF NuGet Paket. Dies können Sie über die .NET Befehlszeilenschnittstelle (CLI) tun:

dotnet add package IronPdf

dotnet add package IronPdf

Oder über die NuGet Paket-Manager-Konsole in Visual Studio:

Install-Package IronPdf

Install-Package IronPdf

Nach der Installation haben Sie Zugriff auf ChromePdfRenderer, wodurch die gesamte iTextSharp + XMLWorker-Pipeline durch einen einzigen, zuverlässigen Aufruf ersetzt wird.

Wie rendert man HTML in PDF mit IronPDF?

Das folgende Beispiel rendert denselben HTML-Rechnungscode, der in iTextSharp zu Fehlern geführt hat. Beachten Sie, dass es keine Workarounds, keine einzufügenden leeren Absätze und keine stillen Fehler gibt, die behandelt werden müssen:

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

Wie sieht die IronPDF Ausgabe aus?

Warum beseitigt dieser Ansatz Parsing-Fehler?

Mit diesem Code wird die PDF-Datei ausnahmslos erfolgreich erstellt. Die Methode verarbeitet komplexe HTML- und CSS-Inhalte automatisch, so dass keine Umgehungslösungen erforderlich sind. Der Inhalt wird pixelgenau wiedergegeben und entspricht der Browser-Vorschau. IronPDF unterstützt außerdem asynchrones Rendering , benutzerdefinierte Ränder und PDF-Komprimierung für optimierte Dateigrößen.

Für Szenarien mit vielen JavaScript-Inhalten oder Single-Page-Anwendungen ermöglicht die Option RenderDelay von IronPDF die Ausführung des JavaScript vor der PDF-Erfassung – etwas, was XMLWorker überhaupt nicht kann. Das folgende Beispiel fügt Kopf- und Fußzeilen sowie Sicherheitseinstellungen in einem produktionsreifen, asynchronen Muster hinzu:

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

Wie migriert man von iTextSharp zu IronPDF?

Für Entwickler, die mit dem Fehler "Dokument hat keine Seiten" konfrontiert sind, bietet die Migration zu IronPDF eine sofortige Lösung. Der Konvertierungsprozess ist unkompliziert, und IronPDF bietet eine vollständige Dokumentation sowie Codebeispiele . Der folgende Vorher-Nachher-Vergleich verdeutlicht die Reduzierung der Komplexität:

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

Was macht die IronPDF-API entwicklerfreundlicher?

Die vereinfachte API bedeutet, dass weniger Code gewartet werden muss und keine Parsing-Fehler zu beheben sind. IronPDF bietet außerdem Funktionen zum Hinzufügen von Kopf- und Fußzeilen , zum Zusammenführen von PDFs und zum Anwenden digitaler Signaturen ohne aufwendige Umwege. Für Teams, die in Docker-Umgebungen arbeiten oder auf Linux-Servern bereitstellen, bietet IronPDF ein einheitliches Verhalten über alle Plattformen hinweg.

Mit NuGet installieren

PM >  Install-Package IronPdf

Schauen Sie sich IronPDF auf NuGet für eine schnelle Installation an. Mit über 10 Millionen Downloads transformiert es die PDF-Entwicklung mit C#. Sie können auch das DLL oder den Windows Installer herunterladen.

Starten Sie Ihre kostenlose Testphase und erleben Sie eine fehlerfreie HTML-zu-PDF-Konvertierung .