C#でDataURIsを使用して画像を埋め込む & VB PDFレンダリング

更新日:2026年4月23日

Translated

View the article in English

IronPDF を使用し、C# および VB.NET で DataURIs を使用して画像を PDF 文書に直接埋め込みます。画像のバイト列を base64 文字列に変換し、HTML マークアップ内にインラインで含めることで、外部ファイルへの依存を排除し、シームレスな PDF レンダリングを実現します。

HTML文字列やドキュメントを扱う場合、アセットディレクトリへの依存を避けることが不可欠です。データURIスキームは、効果的なソリューションを提供します。

データURIスキームは、HTMLまたはCSSコードに直接データを埋め込み、別ファイルの必要性を排除します。 DataURIs を使用すると、画像、ファイル、およびフォントを文字列として HTML ドキュメントに直接埋め込むことができます。

クイックスタート: DataURI を使用して PDF に画像を埋め込む

IronPDF を使用して DataURIs を適用し、画像を埋め込むことで、HTML コンテンツを PDF 文書に変換します。このガイドでは、シンプルで効率的なコードを使用して、画像を埋め込んだPDFをレンダリングする方法を示します。 IronPDFは画像の整合性を保ちながらHTMLをPDFに変換します。以下は、DataURI を使用して最小限のコードで画像を PDF 文書に直接埋め込む方法を示す、わかりやすい例です。

IronPDF をNuGetパッケージマネージャでインストール
PM > Install-Package IronPdf

このコードスニペットをコピーして実行します。

new IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<img src='data:image/png;base64,...' />").SaveAs("output.pdf");

実際の環境でテストするためにデプロイする

今日プロジェクトで IronPDF を使い始めましょう無料トライアル

最小限のワークフロー（5ステップ）

NuGetからIronPDFをダウンロードする。
ReadAllBytesメソッドを使用して画像のバイトを読み取ります。
バイトを base64 に変換するには、ToBase64String メソッドを使用します。
imgタグにbase64の情報を含めてください。
HTMLをPDFにレンダリング

PDFにDataURIを使って画像を埋め込むには?

DataURIs を使用した画像の埋め込みは、外部ファイルを参照することなく、HTML マークアップ内に画像を直接含める方法です。このアプローチは、クラウド環境や分散システムでPDFを生成する場合や、すべてのリソースが自己完結していることを保証する場合に有効です。 IronPDFのHTMLからPDFへの変換機能はDataURIsを完全にサポートしており、画像を埋め込んだProfessionalなPDFの作成が可能です。

このプロセスは、画像データの読み取り、Base64形式への変換、HTMLのimgタグへの埋め込みという3つのステップで構成されています。この方法は、PNG、JPEG、GIF、SVGを含むさまざまな画像フォーマットに対応し、PDF生成ワークフローに柔軟性をもたらします。 Azure Blob Storageイメージを扱う場合でも、ローカルファイルを扱う場合でも、テクニックは一貫しています。

基本的な画像埋め込み例

この完全な例は、DataURIを使ってPDFに画像を埋め込む方法を示しています：

:path=/static-assets/pdf/content-code-examples/how-to/datauris-image.cs

using IronPdf;
using System;

// Read byte from image file
var pngBinaryData = System.IO.File.ReadAllBytes("My_image.png");

// Convert bytes to base64
var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

// Import base64 to img tag
var ImgHtml = $"<img src='{ImgDataURI}'>";

ChromePdfRenderer Renderer = new ChromePdfRenderer();

// Render the HTML string
var pdf = Renderer.RenderHtmlAsPdf(ImgHtml);

pdf.SaveAs("datauri_example.pdf");

Imports IronPdf
Imports System

' Read byte from image file
Private pngBinaryData = System.IO.File.ReadAllBytes("My_image.png")

' Convert bytes to base64
Private ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

' Import base64 to img tag
Private ImgHtml = $"<img src='{ImgDataURI}'>"

Private Renderer As New ChromePdfRenderer()

' Render the HTML string
Private pdf = Renderer.RenderHtmlAsPdf(ImgHtml)

pdf.SaveAs("datauri_example.pdf")

$vbLabelText $csharpLabel

VB.NET開発者はIronPDFのVB.NET PDFライブラリを使用して同じ機能を実現することができます：

Imports IronPdf
Imports System

' Read byte from image file
Dim pngBinaryData As Byte() = System.IO.File.ReadAllBytes("My_image.png")

' Convert bytes to base64
Dim ImgDataURI As String = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

' Import base64 to img tag
Dim ImgHtml As String = $"<img src='{ImgDataURI}'>"

Dim Renderer As New ChromePdfRenderer()

' Render the HTML string
Dim pdf = Renderer.RenderHtmlAsPdf(ImgHtml)

pdf.SaveAs("datauri_example.pdf")

なぜファイル参照の代わりにDataURIを使用する必要があるのですか

DataURIsは、PDFを生成する際、従来のファイル参照に比べていくつかの利点があります。まず、外部ファイルへの依存を排除し、PDF生成の信頼性と移植性を高めます。これは、Azure や AWS Lambda のようなクラウド環境で、ファイルシステムへのアクセスが制限されたり、パフォーマンスが重視されたりする場合に非常に重要です。

第二に、DataURIs により、PDF が完全に自己完結型であることが保証されます。生成されたPDFを共有または配布する場合、画像リンクの破損やリソースの欠落は問題になりません。これにより、DataURIsは、レポートや請求書、あるいはアーカイブやメール配信が必要な文書の作成に最適です。

第三に、DataURIsは特定のシナリオにおいてパフォーマンスを向上させることができます。画像データはHTMLに直接埋め込まれるため、レンダリング時に追加のHTTPリクエストやファイルシステム操作は発生しません。これは、特に複数の小さな画像を扱う場合に、PDF生成の高速化につながります。

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

IronPDFはDataURIsを通じてすべての主要な画像形式をサポートしており、PDF生成ワークフローに柔軟性をもたらします：

PNG：透明度のある画像やシャープなエッジのあるグラフィックに最適です。 data:image/png;base64,を使用してください
JPEG：写真や色の多い複雑な画像に最適です。 data:image/jpeg;base64,を使用してください
GIF：シンプルなアニメーションや、色数が限られている画像に適しています。 data:image/gif;base64, を使用してください
SVG：スケーラブルなベクターグラフィックスに最適です。 data:image/svg+xml;base64, を使用してください
WebP：圧縮に優れた最新のフォーマット。 data:image/webp;base64, を使用してください

次の例では、異なる画像形式をどのように扱うかを示しています：

using IronPdf;
using System;
using System.IO;

public class MultiFormatImageEmbedding
{
    public static void EmbedVariousImageFormats()
    {
        var renderer = new ChromePdfRenderer();

        // Function to create DataURI from image file
        string CreateDataUri(string filePath, string mimeType)
        {
            var imageBytes = File.ReadAllBytes(filePath);
            return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}";
        }

        // Create HTML with multiple image formats
        var html = $@"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("multi_format_images.pdf");
    }
}

using IronPdf;
using System;
using System.IO;

public class MultiFormatImageEmbedding
{
    public static void EmbedVariousImageFormats()
    {
        var renderer = new ChromePdfRenderer();

        // Function to create DataURI from image file
        string CreateDataUri(string filePath, string mimeType)
        {
            var imageBytes = File.ReadAllBytes(filePath);
            return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}";
        }

        // Create HTML with multiple image formats
        var html = $@"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("multi_format_images.pdf");
    }
}

Imports IronPdf
Imports System
Imports System.IO

Public Class MultiFormatImageEmbedding
    Public Shared Sub EmbedVariousImageFormats()
        Dim renderer As New ChromePdfRenderer()

        ' Function to create DataURI from image file
        Function CreateDataUri(filePath As String, mimeType As String) As String
            Dim imageBytes = File.ReadAllBytes(filePath)
            Return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}"
        End Function

        ' Create HTML with multiple image formats
        Dim html = $"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>"

        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("multi_format_images.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

既存のPDFへの画像の追加を含む高度な画像処理のために、IronPDFは包括的なサポートを提供します。

Base64エンコーディングはファイルサイズにどのように影響しますか?

Base64エンコーディングは、データサイズを約33%増加させます。 Base64は、64のASCII文字のみを使用してバイナリデータを表し、元のデータの3バイトごとに4文字を必要とします。このため、全体的なサイズは大きくなりますが、自己完結型ドキュメントの利点に比べれば、PDF生成への影響は最小限であることがほとんどです。

DataURIs を使用する際は、以下のベストプラクティスに従ってファイルサイズを最適化してください：

エンコード前に画像を圧縮: ツールやライブラリを使用して、base64に変換する前に画像ファイルを最適化します。
適切なフォーマットを選択: 写真にはJPEGを、透明性のあるグラフィックにはPNGを使用します。
画像を適切にリサイズ: PDF出力に必要以上に大きな画像を埋め込まないでください。 4.PDFの圧縮を考慮する：生成後にIronPDFの圧縮機能を使用してください。

この例では、埋め込み前の画像の最適化を示しています：

using IronPdf;
using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;

public class OptimizedImageEmbedding
{
    public static void EmbedOptimizedImage(string imagePath, int maxWidth = 800)
    {
        // Load and resize image if necessary
        using (var originalImage = Image.FromFile(imagePath))
        {
            var resizedImage = originalImage;

            if (originalImage.Width > maxWidth)
            {
                var ratio = (double)maxWidth / originalImage.Width;
                var newHeight = (int)(originalImage.Height * ratio);
                resizedImage = new Bitmap(originalImage, maxWidth, newHeight);
            }

            // Convert to optimized JPEG
            using (var ms = new MemoryStream())
            {
                var encoder = ImageCodecInfo.GetImageEncoders()
                    .First(c => c.FormatID == ImageFormat.Jpeg.Guid);
                var encoderParams = new EncoderParameters(1);
                encoderParams.Param[0] = new EncoderParameter(
                    System.Drawing.Imaging.Encoder.Quality, 85L);

                resizedImage.Save(ms, encoder, encoderParams);
                var imageBytes = ms.ToArray();

                // Create DataURI
                var dataUri = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}";

                // Generate PDF
                var html = $@"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>";

                var renderer = new ChromePdfRenderer();
                var pdf = renderer.RenderHtmlAsPdf(html);
                pdf.SaveAs("optimized_image.pdf");
            }

            if (resizedImage != originalImage)
                resizedImage.Dispose();
        }
    }
}

using IronPdf;
using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;

public class OptimizedImageEmbedding
{
    public static void EmbedOptimizedImage(string imagePath, int maxWidth = 800)
    {
        // Load and resize image if necessary
        using (var originalImage = Image.FromFile(imagePath))
        {
            var resizedImage = originalImage;

            if (originalImage.Width > maxWidth)
            {
                var ratio = (double)maxWidth / originalImage.Width;
                var newHeight = (int)(originalImage.Height * ratio);
                resizedImage = new Bitmap(originalImage, maxWidth, newHeight);
            }

            // Convert to optimized JPEG
            using (var ms = new MemoryStream())
            {
                var encoder = ImageCodecInfo.GetImageEncoders()
                    .First(c => c.FormatID == ImageFormat.Jpeg.Guid);
                var encoderParams = new EncoderParameters(1);
                encoderParams.Param[0] = new EncoderParameter(
                    System.Drawing.Imaging.Encoder.Quality, 85L);

                resizedImage.Save(ms, encoder, encoderParams);
                var imageBytes = ms.ToArray();

                // Create DataURI
                var dataUri = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}";

                // Generate PDF
                var html = $@"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>";

                var renderer = new ChromePdfRenderer();
                var pdf = renderer.RenderHtmlAsPdf(html);
                pdf.SaveAs("optimized_image.pdf");
            }

            if (resizedImage != originalImage)
                resizedImage.Dispose();
        }
    }
}

Imports IronPdf
Imports System
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Class OptimizedImageEmbedding
    Public Shared Sub EmbedOptimizedImage(imagePath As String, Optional maxWidth As Integer = 800)
        ' Load and resize image if necessary
        Using originalImage As Image = Image.FromFile(imagePath)
            Dim resizedImage As Image = originalImage

            If originalImage.Width > maxWidth Then
                Dim ratio As Double = CDbl(maxWidth) / originalImage.Width
                Dim newHeight As Integer = CInt(originalImage.Height * ratio)
                resizedImage = New Bitmap(originalImage, maxWidth, newHeight)
            End If

            ' Convert to optimized JPEG
            Using ms As New MemoryStream()
                Dim encoder As ImageCodecInfo = ImageCodecInfo.GetImageEncoders().First(Function(c) c.FormatID = ImageFormat.Jpeg.Guid)
                Dim encoderParams As New EncoderParameters(1)
                encoderParams.Param(0) = New EncoderParameter(System.Drawing.Imaging.Encoder.Quality, 85L)

                resizedImage.Save(ms, encoder, encoderParams)
                Dim imageBytes As Byte() = ms.ToArray()

                ' Create DataURI
                Dim dataUri As String = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}"

                ' Generate PDF
                Dim html As String = $"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>"

                Dim renderer As New ChromePdfRenderer()
                Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
                pdf.SaveAs("optimized_image.pdf")
            End Using

            If resizedImage IsNot originalImage Then
                resizedImage.Dispose()
            End If
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

高度なテクニックとベストプラクティス

本番環境で DataURIs を使用する際は、同じ画像を繰り返しエンコードすることを避けるため、キャッシュ機構を実装してください。これは、リソースを共有して複数のPDFを生成する場合に特に重要です。複数の画像を処理する際は、IronPDFのasync機能を活用してパフォーマンスを向上させてください。

画像が多数含まれる複雑なドキュメントについては、重要な画像は DataURIs として埋め込み、より大きなオプションの画像は外部参照とするハイブリッドなアプローチを採用してください。このため、自己完結型の文書と適度なファイルサイズのバランスが求められます。

また、IronPDFのASP.NET MVCインテグレーションを使って、HTML文字列やPDFドキュメント全体をバイト配列として提供することもできます。このテクニックは、PDFを動的に生成して提供するWebアプリケーションを構築するときに効果的です。

電子透かし、電子署名、フォームの作成を含む高度なPDF操作技術については、IronPDFは堅牢なPDFソリューションを構築するための包括的なドキュメントと例を提供します。

C# または VB.NET プロジェクトに IronPdf 名前空間を含めるには、using IronPdf ディレクティブを使用してください。

AddBookmarkAtEnd メソッドは、PDFのアウトラインに新しいブックマークを追加するために使用されます。

よくある質問

DataURIとは何ですか？なぜPDF生成に使うのですか？

DataURIはHTMLやCSSコードにbase64エンコードされた文字列として直接データを埋め込むスキームで、個別の画像ファイルを必要としません。IronPDFはDataURIを完全にサポートしており、クラウド環境、分散システム、または外部ファイル依存のない自己完結型のPDFが必要な場合に理想的です。

PDF埋め込み用に画像をDataURI形式に変換するにはどうすればよいですか？

IronPDFで画像をDataURIに変換するには3つのステップがあります：まず、System.IO.File.ReadAllBytes()を使って画像のバイトを読み込みます。次に、Convert.ToBase64String()を使ってバイトをbase64に変換します。最後に、base64文字列をHTMLのimgタグに「data:image/png;base64,[base64string]」という形式で埋め込みます。

DataURIとして画像を埋め込む場合、どのような画像形式がサポートされますか？

IronPDFはPNG、JPEG、GIF、SVGを含む様々な画像フォーマットをDataURIとして埋め込むことをサポートしています。この柔軟性により、PDF生成のワークフローを完全に制御しながら、異なる種類の画像を扱うことができます。

1つのPDFにDataURIを使って複数の画像を埋め込むことはできますか？

はい、IronPDFではDataURIを使って複数の画像を一つのPDFドキュメントに埋め込むことができます。IronPDFのChromePdfRendererでレンダリングする前に、それぞれの画像をbase64表現に変換してHTMLマークアップに含めるだけです。

ファイル参照の代わりにDataURIを使用した場合、パフォーマンスに影響はありますか？

DataURIはbase64エンコーディングのためHTML文字列のサイズを増加させますが、IronPDFは効率的に変換を処理します。トレードオフは、特にクラウドや分散環境において、外部依存のない自己完結型のPDFが必要な場合に価値があります。

カーティス・チャウ

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 19,014,616 | バージョン: 2026.5 just released

ライセンスを見る

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。

ライセンスを見る

顧客ハイライト:

開発者スポットライト:

ウェビナー:

30日間無料トライアルを開始

このページでは

C#でDataURIsを使用して画像を埋め込む & VB PDFレンダリング

IronPDF をNuGetパッケージマネージャでインストール

このコードスニペットをコピーして実行します。

実際の環境でテストするためにデプロイする

最小限のワークフロー（5ステップ）

PDFにDataURIを使って画像を埋め込むには?

基本的な画像埋め込み例

なぜファイル参照の代わりにDataURIを使用する必要があるのですか

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

Base64エンコーディングはファイルサイズにどのように影響しますか?

高度なテクニックとベストプラクティス

よくある質問

DataURIとは何ですか？なぜPDF生成に使うのですか？

PDF埋め込み用に画像をDataURI形式に変換するにはどうすればよいですか？

DataURIとして画像を埋め込む場合、どのような画像形式がサポートされますか？

1つのPDFにDataURIを使って複数の画像を埋め込むことはできますか？

ファイル参照の代わりにDataURIを使用した場合、パフォーマンスに影響はありますか？

まだスクロールしていますか?

アイアンサポートチーム

30日間無料トライアルを開始

このページでは

C#でDataURIsを使用して画像を埋め込む & VB PDFレンダリング

IronPDF をNuGetパッケージマネージャでインストール

このコード スニペットをコピーして実行します。

実際の環境でテストするためにデプロイする

最小限のワークフロー（5ステップ）

PDFにDataURIを使って画像を埋め込むには?

基本的な画像埋め込み例

なぜファイル参照の代わりにDataURIを使用する必要があるのですか

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

Base64エンコーディングはファイルサイズにどのように影響しますか?

高度なテクニックとベストプラクティス

よくある質問

DataURIとは何ですか？なぜPDF生成に使うのですか？

PDF埋め込み用に画像をDataURI形式に変換するにはどうすればよいですか？

DataURIとして画像を埋め込む場合、どのような画像形式がサポートされますか？

1つのPDFにDataURIを使って複数の画像を埋め込むことはできますか？

ファイル参照の代わりにDataURIを使用した場合、パフォーマンスに影響はありますか？

まだスクロールしていますか?

無料をゲット

次のステップ：30日間の無料トライアルを開始

Thank You

次のステップ：30日間の無料トライアルを開始

Want to deploy IronSuite to a live project for FREE?

What’s included?

世界中の数百万人のエンジニアから信頼されています。

アイアンサポートチーム

このコードスニペットをコピーして実行します。