iTextSharpの「ドキュメントにページがありません」エラーをHTMLからPDFへの変換で修正 | IronPDF

このエラーが発生すると、コンソール出力には何が表示されますか?

このコードは HTML から PDF ファイルを作成しようとしますが、XMLWorker が HTML コンテンツを正常に解析できなかったため例外が発生します。 書き込み操作は完了しましたが、ドキュメントにコンテンツが追加されず、空のファイルが作成されます。この解析エラーは、 ASP.NETアプリケーションでHTMLからPDFへの変換を行う際に開発者が直面する最も一般的な問題の1つです。 カスタム CSS スタイルや JavaScript でレンダリングされたコンテンツを扱う場合、問題はさらに複雑になります。

この回避策では PDF 出力はどのようになりますか?

<img src="/static-assets/pdf/blog/itextsharp-html-to-pdf-no-page/itextsharp-html-to-pdf-no-page-2.webp" alt=""Hello, World!"の見出しと"Draft version"のヘッダー、テストコンテンツを表示するPDFが正常に生成されました。"ドキュメントにページがありません"エラーを防ぐための空の段落の回避策を実装した後、XMLWorkerのHTMLレンダリングが正常に行われたことを示しています。">

複雑な HTML 要素がレンダリングに失敗する理由は何ですか?

空の段落を追加すると、即時のエラーは回避されますが、表要素、画像、またはカスタム フォントを含む複雑な HTML は、正しくレンダリングされないことがよくあります。 生成された PDF ドキュメントの内容が欠落しているか、形式が正しくない可能性があります。 開発者は、埋め込みスタイル、ハイパーリンク要素、または特定の幅プロパティを持つ HTML を処理するときにも同じ問題に遭遇します。 null 参照と要素のレンダリングの欠落により、さらなる解決を必要とする追加の問題が発生します。

XMLWorkerは、HTML 4の一部と基本的なCSS 2を処理するように設計されていました。現代のWebページでは、CSS Grid、Flexbox、CSS変数、​​calc()式、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 NotSupportedException("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 NotSupportedException("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 Developer Network の 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 はプラットフォーム間で一貫した動作を提供します。

購入の準備ができていませんか？

PM >  Install-Package IronPdf

IronPDF を NuGet でチェックしてください。1000万回以上のダウンロードで、C#によるPDF開発を変革しています。 DLL または Windowsインストーラー をダウンロードすることもできます。

無料トライアルを開始して、エラーのないHTML から PDF への変換を体験してください。