Napraw błąd iTextSharp „Dokument nie ma stron” podczas konwersji HTML do PDF | IronPDF

Co wyświetla konsola, gdy pojawia się ten błąd?

Ten kod próbuje utworzyć plik PDF z HTML, ale napotyka wyjątek, ponieważ XMLWorker nie mógł pomyślnie przeanalizować treści HTML. Operacja zapisu zostaje zakończona, ale do dokumentu nie zostaje dodana żadna treść, co skutkuje powstaniem pustego pliku. Ten błąd parsowania jest jednym z najczęstszych problemów, z jakimi borykają się programiści podczas konwersji HTML do PDF w aplikacjach ASP.NET. Problem staje się bardziej złożony w przypadku niestandardowych stylów CSS lub treści renderowanych przez JavaScript.

Jak wygląda plik PDF wygenerowany przy użyciu tego rozwiązania?

Dlaczego złożone elementy HTML nadal nie wyświetlają się prawidłowo?

Dodanie pustego akapitu zapobiega natychmiastowemu błędowi, ale złożony kod HTML zawierający elementy tabel, obrazy lub niestandardowe czcionki często nie wyświetla się poprawnie. W wynikowym dokumencie PDF treść może być niekompletna lub nieprawidłowa. Programiści napotykają ten sam problem podczas przetwarzania kodu HTML zawierającego osadzone style, elementy hiperłączy lub określone właściwości szerokości. Odwołania do wartości null i brak renderowania elementów powodują dodatkowe problemy, które wymagają dalszego rozwiązania.

XMLWorker został zaprojektowany do obsługi podzbioru HTML 4 i podstawowego CSS 2. Niewoczesne strony internetowe rutynowo wykorzystują funkcje znacznie wykraczające poza ten zakres: CSS Grid, Flexbox, zmienne CSS, wyrażenia calc(), grafikę SVG oraz renderowanie oparte na JavaScript. Każda z tych sytuacji może wywołać błąd "brak stron" lub spowodować ciche wygenerowanie uszkodzonego wyniku — bez opisowego komunikatu o błędzie, który pomógłby w naprawie.

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

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

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

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

    // Czcionki niestandardowe -- 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 NietSupportedException("Flexbox layout not supported")
    End If

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

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

Co się dzieje, gdy iTextSharp przetwarza tę fakturę?

Kiedy iTextSharp przetwarza ten szablon faktury, wynik często jest pozbawiony stylów CSS, brakuje kolorów tła i znikają obramowania tabel. Zapytanie @media print jest ignorowane, a wszelkie odniesienia do czcionek internetowych powodują ciche błędy parsowania. Jeśli kod HTML zawiera właściwość CSS, której XMLWorker nie rozpoznaje, renderowanie całego bloku może się nie powieść — co spowoduje brak treści bez wygenerowania błędu podczas parsowania.

W jaki sposób IronPDF renderuje tę samą fakturę?

Dlaczego te elementy HTML powodują problemy w iTextSharp?

W przypadku XMLWorker firmy iTextSharp ta faktura może nie zostać przetworzona z powodu stylów tabel, właściwości szerokości lub specyfikacji czcionek. Błąd "dokument nie ma stron" często pojawia się, gdy te elementy nie są obsługiwane. Hiperłącza i odniesienia do zapytań o media również mogą nie wyświetlać się poprawnie. Ograniczenia te stają się krytyczne podczas wdrażania zaawansowanych funkcji PDF, takich jak podpisy cyfrowe lub numery stron w aplikacjach biznesowych.

Zgodnie z dokumentacją Mozilla Developer Network dotyczącą CSS, nowoczesny CSS zawiera setki właściwości i wartości, które przeglądarki obsługują natywnie. XMLWorker obsługuje tylko niewielką część z nich, dlatego rzeczywiste treści internetowe konsekwentnie powodują błędy parsowania.

Jak zainstalować IronPDF za pomocą NuGet?

Przed napisaniem jakiegokolwiek kodu zainstaluj pakiet IronPDF NuGet. Można to zrobić z poziomu interfejsu CLI platformy .NET:

dotnet add package IronPdf

dotnet add package IronPdf

Lub z konsoli menedżera pakietów NuGet w Visual Studio:

Install-Package IronPdf

Install-Package IronPdf

Po zainstalowaniu uzyskasz dostęp do ChromePdfRenderer, który zastępuje cały potok iTextSharp + XMLWorker jednym, niezawodnym wywołaniem.

Jak przekonwertować HTML na PDF za pomocą IronPDF?

Poniższy przykład renderuje ten sam kod HTML faktury, który powodował błędy w iTextSharp. Należy zauważyć, że nie ma żadnych obejść, pustych akapitów do dodania na początku ani cichych błędów do obsługi:

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

Jak wygląda wynik działania IronPDF?

Dlaczego to podejście eliminuje błędy parsowania?

Ten kod z powodzeniem tworzy plik PDF bez żadnych wyjątków. Metoda ta automatycznie obsługuje złożony kod HTML i CSS, eliminując potrzebę stosowania obejść. Treść wyświetla się idealnie, zgodnie z podglądem w przeglądarce. IronPDF obsługuje również renderowanie asynchroniczne, niestandardowe marginesy oraz kompresję plików PDF w celu optymalizacji rozmiarów plików.

W scenariuszach obejmujących treści oparte w dużej mierze na JavaScript lub aplikacje jednostronicowe opcja RenderDelay programu IronPDF pozwala na wykonanie kodu JavaScript przed przechwyceniem pliku PDF — czego XMLWorker w ogóle nie potrafi. Poniższy przykład dodaje nagłówki, stopki i ustawienia zabezpieczeń w gotowym do produkcji wzorcu asynchronicznym:

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

Jak przeprowadzić migrację z iTextSharp do IronPDF?

Dla programistów, którzy napotykają błąd "dokument nie ma stron", przejście na IronPDF stanowi natychmiastowe rozwiązanie. Proces konwersji jest prosty, a IronPDF oferuje kompletną dokumentację i przykłady kodu. Poniższe porównanie "przed i po" pokazuje zmniejszenie złożoności:

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

Co sprawia, że API IronPDF jest bardziej przyjazne dla programistów?

Uproszczony interfejs API oznacza mniej kodu do utrzymania i brak błędów parsowania do debugowania. IronPDF oferuje również funkcje dodawania nagłówków i stopek, łączenia plików PDF oraz stosowania podpisów cyfrowych bez skomplikowanych obejść. Dla zespołów pracujących w środowiskach Docker lub wdrażających rozwiązania na serwerach Linux, IronPDF zapewnia spójne działanie na różnych platformach.

Zainstaluj za pomocą NuGet

PM >  Install-Package IronPdf

Sprawdź IronPDF na NuGet dla szybkiej instalacji. Z ponad 10 milionami pobrań, przekształca rozwój PDF z C#. Możesz również pobrać DLL lub instalator Windows.

Rozpocznij bezpłatny okres próbny, aby doświadczyć bezbłędnej konwersji HTML do PDF.