PuppeteerSharpHTMLからPDFへの実装

PuppeteerSharpは、ブラウザのライフサイクル管理を伴う非同期パターンを必要とします：

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Hello World</h1><p>This is a PDF document.</p>");
        await page.PdfAsync("output.pdf");
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Hello World</h1><p>This is a PDF document.</p>");
        await page.PdfAsync("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

このパターンには以下が必要です：

• 初回使用時にChromiumのバイナリ（~300MB）をダウンロードすること。
• ブラウザインスタンスの起動
• ページコンテキストの作成
• await using<//code> パターンを使ってブラウザのクリーンアップを管理する
• 時間の経過に伴う潜在的なメモリの蓄積への対応

IronPDFHTMLからPDFへの実装

IronPdfは合理化された同期APIを提供します：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF document.</p>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF document.</p>");
        pdf.SaveAs("output.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDFのアプローチはブラウザのライフサイクル管理を完全に排除します。 ChromePdfRendererクラスはレンダリングエンジンをカプセル化し、RenderHtmlAsPdf は単一のメソッド呼び出しで変換を処理します。 BrowserFetcher.DownloadAsync()は必要ありません-レンダリング エンジンは自動的にバンドルされます。

PuppeteerSharpのURL変換

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync("https://www.example.com");
        await page.PdfAsync("webpage.pdf");
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync("https://www.example.com");
        await page.PdfAsync("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

PuppeteerSharpのURL変換は、PDF生成前のナビゲーションにGoToAsyncを使用し、同じ非同期ブラウザライフサイクルパターンに従います。

IronPDFのURL変換

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDFのRenderUrlAsPdf メソッドはナビゲーションとレンダリングを1回の呼び出しで処理し、ページコンテンツに対するインテリジェントなビルトインウェイティングを備えています。

PuppeteerSharpのカスタム設定

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");

        await page.PdfAsync("custom.pdf", new PdfOptions
        {
            Format = PaperFormat.A4,
            Landscape = true,
            MarginOptions = new MarginOptions
            {
                Top = "20mm",
                Bottom = "20mm",
                Left = "20mm",
                Right = "20mm"
            }
        });
    }
}

// NuGet: Install-Package PuppeteerSharp
using PuppeteerSharp;
using PuppeteerSharp.Media;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");

        await page.PdfAsync("custom.pdf", new PdfOptions
        {
            Format = PaperFormat.A4,
            Landscape = true,
            MarginOptions = new MarginOptions
            {
                Top = "20mm",
                Bottom = "20mm",
                Left = "20mm",
                Right = "20mm"
            }
        });
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

PuppeteerSharpは、文字列ベースのマージン値と、PdfAsyncメソッドに渡されるPdfOptionsオブジェクトを使用します。

IronPDFカスタム設定

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;

        var pdf = renderer.RenderHtmlAsPdf("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");
        pdf.SaveAs("custom.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;
        renderer.RenderingOptions.MarginLeft = 20;
        renderer.RenderingOptions.MarginRight = 20;

        var pdf = renderer.RenderHtmlAsPdf("<h1>Custom PDF</h1><p>With landscape orientation and margins.</p>");
        pdf.SaveAs("custom.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPdfはRenderingOptionsプロパティを通してミリメートル単位のマージン値を使用し、明確な単位セマンティクスを提供します。 レンダラーは一度設定すれば、複数の変換に再利用できます。

PuppeteerSharpの強み

• Chromiumエンジンによる最新のCSS3サポート
• スクレイピングとテストのためのリッチブラウザインタラクション
• GoogleのPuppeteer APIの直接移植
• フリー＆オープンソース

PDF生成におけるPuppeteerSharpの制限事項

• 300MB 以上の Chromium 依存性
• 持続的な負荷によるメモリリーク
• ドキュメント生成のためのブラウザ自動化オーバーヘッド
• PDF/AまたはPDF/UAに準拠していない
• PDF操作機能なし
• 複雑な非同期パターンが必要

IronPDFの強み

• PDFの生成と操作に特化しています。
• 外部ブラウザのダウンロードは不要
• 自動メモリ管理
• 包括的な機能セット（署名、セキュリティ、フォーム）
• PDF/AおよびPDF/UAコンプライアンス対応
• 同期と非同期の両方のAPIパターン
• ドキュメンテーションによるIronPDFサポート。

IronPDFについての考察

• 商用ライセンスモデル
• PDF操作に特化（ブラウザ自動化ではない）