C#でHTMLをPDFに変換する方法（デベロッパーガイド）

HTML文字列をPDFに変換する方法

最も基本的な操作は、HTML 文字列を PDF に変換することです。 このメソッドは、動的に生成された HTML コンテンツに最適です。 RenderHtmlAsPdfメソッドは、HTMLを直接PDFに変換するときに、HTML5、CSS3、JavaScript、画像を完全にサポートします。

using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");

using IronPdf;

// Create the Chrome renderer
var renderer = new ChromePdfRenderer();

// Convert HTML string to PDF
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");

// Save the PDF
pdf.SaveAs("output.pdf");

BRACKET-t-OPEN--(v2025.9.4用に更新) 最近の更新により、HTMLメタデータ内の特殊文字/絵文字に関する問題が修正され、Linux上での漢字を含むhtmlフォームフィールドの処理が改善されました。 最適な結果を得るには、EnableJavaScript = trueで動的コンテンツをテストしてください。

HTML文字列が画像やスタイルシートのようなローカル資産を参照する場合、すべてのリソースを含むHTMLコンテンツを適切に変換するために、BaseUrlPathパラメータを使用してください：

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Convert HTML content with local image and CSS references
string html = @"
    <link rel='stylesheet' href='styles.css'>
    <img src='logo.png' alt='Company Logo'>
    <h1>Company Report</h1>
    <p>Annual report content...</p>";

// Set base path for resolving relative URLs in HTML to PDF conversion
var pdf = renderer.RenderHtmlAsPdf(html, @"C:\MyProject\Assets\");
pdf.SaveAs("report.pdf");

BaseUrlPathはIronPDFにCSS、JavaScript、画像ファイルの場所を伝えます。 HTML文字列内のすべての相対パスは、このディレクトリから解決されます。

関連するハウツー記事: How to Convert HTML String to PDF in C#

このアプローチでは、指定された任意のURLを直接PDF形式に変換できます。

印刷とスクリーンのCSS IronPDFを構成して、どちらのCSSメディアタイプでもレンダリングできます。

JavaScriptサポート

IronPDF を構成して、CSS メディアタイプのいずれかを使用してレンダリングできます。

using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen

using IronPdf;
using IronPdf.Rendering;

// Initialize HTML to PDF converter
var renderer = new ChromePdfRenderer();

// Configure CSS media type for rendering specified URLs
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;

// Screen media type shows the entire web page as displayed on screen

動的なHTMLコンテンツ用には、IronPDFを設定してJavaScriptが完了するのを待機してからWebページをPDFにレンダリングすることができます。

これはシングルページアプリケーションや動的Webサイトに最適です。 動的HTMLコンテンツの場合、IronPDFを構成してJavaScriptの完了を待ってからウェブページをPDFにレンダリングできます。 これはシングルページアプリケーションや動的ウェブサイトに最適です。

using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

using IronPdf;

// Configure JavaScript rendering for dynamic HTML content to PDF
var renderer = new ChromePdfRenderer();

// Enable JavaScript execution during PDF generation
renderer.RenderingOptions.EnableJavaScript = true;

// WaitFor.RenderDelay pauses before capturing the HTML
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

レスポンシブなWebページはブラウザで見るために設計されており、IronPDFはサーバーのOSで実ブラウザウィンドウを開かないため、レスポンシブHTML要素は最小サイズでレンダリングされることがあります。 PdfCssMediaType.Print はWebページ全体をレンダリングする際にこの問題をナビゲートするのにお勧めです。

using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");

using IronPdf;

// Create renderer for JavaScript-heavy HTML
var renderer = new ChromePdfRenderer();

// Convert d3.js visualization web page to PDF
var pdf = renderer.RenderUrlAsPdf("https://bl.ocks.org/mbostock/4062006");

// Save the interactive chart as static PDF
pdf.SaveAs("chart.pdf");

レスポンシブCSS

レスポンシブウェブページはブラウザで表示されるように設計されており、IronPDF はサーバーの OS で実際のブラウザウィンドウを開かないため、レスポンシブ HTML 要素は最小のサイズでレンダリングされることがあります。全体のウェブページをレンダリングする際に、この問題を回避するために PdfCssMediaType.Print を推奨します。

// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Configure for optimal responsive design handling in HTML to PDF

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

関連するハウツー記事: How to Render URL to PDF

HTMLファイルをPDFに変換する方法

ローカルの HTML ファイルを PDF に変換すると、file:// プロトコルを使用して開いたかのように、CSS、画像、JavaScript など、すべての相対アセットが保持されます。 関連の記事: HTMLファイルをPDFにレンダリング

using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF

using IronPdf;

// Initialize ChromePdfRenderer for HTML file conversion
var renderer = new ChromePdfRenderer();

// Convert HTML file to PDF documents
// Preserves all relative paths and linked resources in HTML
var pdf = renderer.RenderHtmlFileAsPdf("Assets/TestInvoice1.html");

// Save the HTML file as PDF 
pdf.SaveAs("Invoice.pdf");

// All CSS, JavaScript, and images load correctly in the generated PDF

HTMLファイルをPDFに変換する前に、ブラウザで編集してテストするために、HTMLファイルをアセット（CSS、画像）とともに別のフォルダに保管してください。 これにより、HTMLが高品質のPDFドキュメントに完璧にレンダリングされます。

関連するハウツー記事: Render HTML File to PDF

バッチPDF作成のためのHTMLテンプレートの生成方法

基本的なバッチ PDF 作成

バッチPDF作成は、複数のパーソナライズされたPDF文書を効率的に生成するために不可欠です。 基本的なシナリオでは、C#のString.Formatメソッドが単純なPDF操作に最適です。

// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>

// Simple HTML templating with String.Format
string htmlTemplate = String.Format("<h1>Hello {0}!</h1>", "World");

// Results in HTML content: <h1>Hello World!</h1>

PDF文書を生成する必要がある場合は、HTMLコンテンツでプレースホルダーの置き換えを使用します： using IronPdf;

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}

// Define reusable HTML template for PDF files
var htmlTemplate = "<p>Dear [[NAME]],</p><p>Thank you for your order.</p>";

// Customer names for batch PDF conversion processing
var names = new[] { "John", "James", "Jenny" };

// Create personalized PDF documents for each customer
var renderer = new ChromePdfRenderer();

foreach (var name in names)
{
    // Replace placeholder with actual data in HTML string
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Generate personalized PDF document from HTML content
    var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save with customer-specific filename as PDF files
    pdf.SaveAs($"{name}-invoice.pdf");
}

非同期メソッドを使用してPDFを生成する方法

HTMLをPDFに変換する際にループや条件文を含む複雑なテンプレートの場合は、Handlebars.NETを使用してダイナミックなHTMLコンテンツを持つPDF文書を生成する高度なテンプレートを使用してください。

# First, install Handlebars.NET for HTML to PDF templating
PM > Install-Package Handlebars.NET

# First, install Handlebars.NET for HTML to PDF templating
PM > Install-Package Handlebars.NET

using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Compile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");

using HandlebarsDotNet;
using IronPdf;

// Define Handlebars template with placeholders for HTML content
var source = 
    @"<div class=""entry"">
        <h1>{{title}}</h1>
        <div class=""body"">
            {{body}}
        </div>
    </div>";

// Compile template for reuse in PDF conversion
var template = Handlebars.Compile(source);

// Create data object (can be database records) for HTML to PDF directly
var data = new { 
    title = "Monthly Report", 
    body = "Sales increased by 15% this month." 
};

// Merge template with data to create HTML content
var htmlResult = template(data);

// Convert templated HTML to PDF using the PDF converter
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlResult);

pdf.SaveAs("monthly-report.pdf");

関連するハウツー記事: Learn more about Handlebars.NET on GitHub

<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <style type="text/css" media="print">
      .page {
        page-break-after: always;
        page-break-inside: avoid;
      }
    </style>
  </head>
  <body>
    <div class="page">
      <h1>Page 1 Content</h1>
    </div>
    <div class="page">
      <h1>Page 2 Content</h1>
    </div>
    <div class="page">
      <h1>Page 3 Content</h1>
    </div>
  </body>
</html>

非同期メソッドを使用してPDFを生成する方法

IronPDFは、スケールでPDFファイルを生成する必要がある場合のHTMLからPDFへの変換要件に対して、完全な非同期およびマルチスレッドサポートを提供するエンタープライズグレードのパフォーマンスを実現します。

using IronPdf;
using System.Threading.Tasks;

// Async method for non-blocking PDF generation from HTML content
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();

    // Async HTML to PDF conversion preserves thread pool
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);

    // Return PDF files as byte array for web responses
    return pdf.BinaryData;
}

// Concurrent batch PDF generation for multiple HTML strings
public async Task GenerateMultiplePdfsAsync(List<string> htmlTemplates)
{
    var renderer = new ChromePdfRenderer();

    // Create parallel conversion tasks to generate PDF documents
    var tasks = htmlTemplates.Select(html => 
        renderer.RenderHtmlAsPdfAsync(html)
    );

    // Await all PDF conversions simultaneously
    var pdfs = await Task.WhenAll(tasks);

    // Save generated PDF files from HTML content
    for (int i = 0; i < pdfs.Length; i++)
    {
        pdfs[i].SaveAs($"document-{i}.pdf");
    }
}

using IronPdf;
using System.Threading.Tasks;

// Async method for non-blocking PDF generation from HTML content
public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();

    // Async HTML to PDF conversion preserves thread pool
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);

    // Return PDF files as byte array for web responses
    return pdf.BinaryData;
}

// Concurrent batch PDF generation for multiple HTML strings
public async Task GenerateMultiplePdfsAsync(List<string> htmlTemplates)
{
    var renderer = new ChromePdfRenderer();

    // Create parallel conversion tasks to generate PDF documents
    var tasks = htmlTemplates.Select(html => 
        renderer.RenderHtmlAsPdfAsync(html)
    );

    // Await all PDF conversions simultaneously
    var pdfs = await Task.WhenAll(tasks);

    // Save generated PDF files from HTML content
    for (int i = 0; i < pdfs.Length; i++)
    {
        pdfs[i].SaveAs($"document-{i}.pdf");
    }
}

HTMLからPDFへの変換におけるパフォーマンス最適化のヒント。

• 最適なPDF生成パフォーマンスのために64ビットシステムを使用してください。
• PDF ドキュメントを生成する際には十分なサーバーリソースを確保します（パワー不足の無料プランを避ける）
• HTML コンテンツの複雑な JavaScript に対して、十分な RenderDelay を許可します。
• 可能な限り、ChromePdfRendererインスタンスを再利用してください。
• バッチ/非同期操作のリソース使用量を削減するために v2025.9.4 メモリ修正を活用します; カスタムヘッダー/フッターを繰り返して、ファイルサイズの削減をテストします。

関連するハウツー記事: How to Generate PDFs with Async and Multithreading

高度なセキュリティ機能を追加する方法

.NETでPDFファイルにパスワード保護を追加する方法

HTMLコンテンツを保護されたPDF形式に変換する際に、パスワードと権限で生成された機密PDF文書を保護します。

using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");

using IronPdf;
var renderer = new ChromePdfRenderer();

// Convert HTML to PDF with security
var pdf = renderer.RenderHtmlAsPdf("<h1>Confidential Report</h1>");

// Configure security settings for PDF files
pdf.SecuritySettings.UserPassword = "user123";     // Password to open PDF documents
pdf.SecuritySettings.OwnerPassword = "owner456";   // Password to modify PDF files

// Set granular permissions for PDF format
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserPrinting = PrintPermissions.LowQualityPrint;

// Apply strong encryption to PDF documents
pdf.SecuritySettings.EncryptionAlgorithm = PdfEncryptionAlgorithm.AES256;
pdf.SaveAs("secure-document.pdf");

PDFファイルにデジタル署名を追加する方法

HTMLコンテンツからPDFファイルを生成する際に、PDF文書の真正性を確保するために暗号署名を追加します。

using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");

using IronPdf;
using IronPdf.Signing;

var renderer = new ChromePdfRenderer();

// Generate PDF from HTML page
var pdf = renderer.RenderHtmlAsPdf("<h1>Contract Agreement</h1>");

// Create digital signature with certificate for PDF files
var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "legal@company.com",
    SigningLocation = "New York, NY",
    SigningReason = "Contract Approval",
    SignerName = "Authorized Signer"  // New property in v2025.8.8 for enhanced signature details
};

// Apply signature to PDF documents
pdf.Sign(signature);
pdf.SaveAs("signed-contract.pdf");

関連するハウツー記事: Digitally Signing PDF Documents with C#

クイック意思決定マトリックス: IronPDFと他の.NET PDFコンバータの比較

詳細な比較: 他の.NET PDFコンバーターに対するIronPDF これらのライブラリを使用する開発者は、HTMLレンダリングをサードパーティのツールに依存しなければなりません

関連する比較:

• IronPDFとSyncfusionを比較する .
• IronPDFとAsposeを比較する .

詳細な比較：IronPDFと他の.NET PDFコンバーターの比較

実際のHTMLからPDFへの変換比較：Redditのホームページのレンダリング

出力PDFの品質を評価するために、動的なウェブコンテンツ、モダンなCSS、JavaScript HTML要素を含むRedditのホームページを使用してこれらのライブラリをテストしました。 このページは、出力PDF生成の理想的なテストケースとして機能します。

https://www.reddit.com/

IronPDF

IronPDFは、Chromeで表示されている通りに、全ての動的なウェブコンテンツ、モダンなウェブフォントスタイリング、およびインタラクティブ要素を完全に保持した結果をわずか数行のコードで提供します。

Syncfusion

Syncfusionは、特に動的コンテンツを欠いて多くのセクションとスタイリングが欠けたPDFをレンダリングしました。 最初はRedditのセキュリティによってブロックされました。 より良い結果を得るには広範なコマンドラインの調整が必要ですが、出力は不完全なままです。

Aspose.PDF

Aspose.PDF は最初に手動で HTML をダウンロードする必要がありました（直接の URL サポートはありません）。 変換後、出力は適切なフォーマットを欠き、ほとんどすべてのコンテンツセクションが欠けていたため、動的なコンテンツを持つモダンなウェブには適していませんでした。

wkhtmltopdf

wkhtmltopdfはすばやく完了しましたが、ライブ更新、動的要素、インタラクティブセクションのような重要なコンテンツが欠けているプレーンな静的ページを生成しました。 これは、wkhtmltopdfがモダンでJavaScript駆動のウェブサイトに対応していないことを示しています。

パフォーマンスと出力PDF品質に関する結論

.NET 開発者にとって信頼性のある HTML から PDF への変換ツールが必要な場合、IronPDF は最小限のコード、使いやすい API、頻繁な製品改善で際立っています。

ウェブコンテンツでの実際のテストでは、最速かつ最も正確な結果が得られ、Syncfusionは後れを取り、Asposeは追加の手順を必要とし、wkhtmltopdfはモダンなスタイリングを逃しました。 IronPDFは、今日のHTMLからPDFへの変換ワークフローにおいて、速度、正確さ、シンプルさの最適なバランスを提供します。

注意事項： Aspose、SyncFusion、wkhtmltopdfはそれぞれの所有者の商標です。 このサイトはそれらと提携しておらず、また、それらからの承認も受けていません。 すべての名前、ロゴ、およびブランドはそれぞれの所有者に帰属し、比較は執筆時点で公開されている情報に基づいています。

概要

このガイドでは、.NETでHTMLをPDFに変換するために必要なすべての事を解説しました：基本的な文字列変換から、非同期処理、デジタル署名、バッチ生成といった高度な機能まで。 3つの変換方法、基本設定、高度な機能とセキュリティ設定を示し、動的なドキュメント生成の実際のテストを通じてIronPDFを他のライブラリと比較しました。

競合他社がモダンなウェブサイトで苦労し、または複雑な解決策を必要としたのに対し、IronPDFは最小限のコードと強力なレンダリングエンジンで完璧な結果を提供しました。

数行のコードでPDFワークフローを効率化し、汎用性のあるPDF生成を体験する準備ができましたか？ NuGetパッケージマネージャー（またはVisual StudioでNuGetパッケージの管理を選択）を通じてIronPDFをインストールし、今日最初のHTMLをPDFに変換してください。

透かしなしでの制作テスト用30日間の無料トライアルを開始 柔軟なライセンス は$799から始まり、チームのニーズに合わせてスケールする透明な価格設定です。

IronPDFのライセンスを見る

一般的なエラーの迅速な解決

• 最初のレンダリングが遅い？ 正常です。 Chromeは2〜3秒で初期化され、その後スピードアップします。
• クラウドの問題？ 少なくともAzure B1または同等のリソースを使用してください。
• 資産が欠けている？ 基本パスを設定するか、base64として埋め込んでください。
• 要素が欠けている？ JavaScriptの実行にRenderDelayを追加してください。
• レンダリングでのメモリー？ HTML to PDF、スタンプ、およびヘッダー/フッターの修正のためにv2025.9.4に更新してください。
• フォームフィールドの問題（例：長いテキストエリア、チェックボックス）？ v2025.7.17で修正されました; チェックボックスにはユニークな名前を使用してください。
• カスタムヘッダー/フッターのクリッピングまたは特殊文字が破損する？ v2025.8.8で解決されました。 テストのワードラッピングとメタデータ。

IronPDFを構築したエンジニアからの24時間年中無休のサポートを受ける

• 総合トラブルシューティング・ガイド
• パフォーマンス最適化戦略
• エンジニアリングサポートリクエスト
• クイック・トラブルシューティング・チェックリスト

次のステップ