IronPDFを使ってC#でPDFに画像を追加する方法

なぜ RenderHtmlAsPdf メソッドが最も効果的なのですか?

RenderHtmlAsPdf メソッドは、IronPDF の Chrome レンダリング エンジンを活用して、レイアウトとスタイルを維持しながら、画像を含む HTML コンテンツを PDF 形式に変換します。 この方法は、レスポンシブCSSレイアウトをサポートし、ウェブブラウザで表示されるとおりに画像がレンダリングされるようにします。 複雑なレイアウトについては、ピクセルパーフェクトなHTMLフォーマットのガイドをご覧ください。

どのような画像形式がサポートされていますか?

IronPdfはHTML変換による埋め込みにおいて、PNG、JPG、SVG、GIF、BMPを含むすべての主要な画像フォーマットをサポートします。 このライブラリは、SVGグラフィックスを効果的に処理し、スケーラブルなベクターイラストを作成します。 異なる形式で作業する場合は、HTML で src 属性または Base64 データ URI に画像タイプが適切に指定されていることを確認してください。

直接 URL と Base64 エンコーディングはいつ使い分けるべきか

画像がオンラインでホストされており、ファイルサイズが懸念される場合は、直接URLを使用してください。 インターネットへのアクセスを必要としない自己完結型のPDFには、Base64エンコーディングを選択してください。 クラウドサービスに保存されている画像については、Azure Blob Storageからの画像の埋め込みに関するガイドを参照してください。 この決定は、生成されたPDFのファイルサイズと移植性の両方に影響します。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

なぜ画像に Base64 エンコードを使用するのですか?

Base64エンコーディングは、外部リソースに依存しない自己完結型のPDFを作成するため、インターネットに接続されていなくても、また元の画像ファイルが移動または削除された場合でも、画像が常に表示されることを保証します。 このテクニックは、BlazorサーバーアプリケーションでPDFを作成するときや、外部ファイルアクセスが制限されている可能性のあるAzureにデプロイするときに役立ちます。 エンコードされた画像はHTML文字列の一部となるため、HTML文字列からPDFへの変換に最適です。

パフォーマンスに関する考慮事項は何ですか?

Base64エンコーディングは、ファイルサイズを約33%増加させますが、外部依存性を排除するため、アーカイブ目的や制限されたネットワーク環境に最適です。 パフォーマンスが重要な場合は、asyncPDF生成を使用して複数の画像変換を同時に処理することを検討してください。 大規模な運用については、パフォーマンスの最適化ガイドを参照して、スループットを最大化してください。

大きな画像ファイルをどのように扱えばよいですか?

大きな画像については、Base64エンコーディングの前に圧縮してPDFファイルサイズを最小にするか、ファイルサイズが重要な場合は外部URLを使用してください。 IronPDFはPDF圧縮機能を提供し、ファイルサイズを最大75%削減することができます。 複数の画像を扱う場合は、レンダリング設定を最適化して、品質とファイルサイズのバランスを最適化してください。

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

次に何ができるのかを見てみましょうか？ チュートリアルのページはこちらをご覧ください：追加機能。