C#で画像をPDFに変換する方法 [コード例チュートリアル]

ど .NET 向け Frameworkバージョンを選択すればよいですか?

IronPDF は、 .NET Framework 4.6.2+、. .NET Core 3.1+、. .NET 5/6/7/8+ など、幅広い.NETバージョンをサポートしています。 新しいプロジェクトでは、最適なパフォーマンスとセキュリティ更新のために、 .NETの最新の LTS (長期サポート) バージョンを使用することをお勧めします。 このライブラリは、 Windows 、 Linux 、 macOSプラットフォームでもシームレスに動作します。

次に、プロジェクトにIronPDF NuGetパッケージをインストールしてその機能を使用します。 IronPDFの優れた点は、独自の API に依存しないため、PDF ドキュメント生成の煩わしさが軽減されることです。HTMLから PDF へのレンダリング機能は、HTML、JS、CSS、JPG、PNG、GIF、SVG といったオープンスタンダードなドキュメント形式から、ピクセルパーフェクトな PDF をレンダリングします。 要するに、開発者がすでに持っているスキルを活用します。

代替のインストール方法は何ですか?

IronPDF は、次の方法でもインストールできます。

• NuGetパッケージ マネージャー UI : プロジェクトを右クリックし、" NuGetパッケージの管理"を選択し、"IronPDF"を検索して"インストール"をクリックします。 -パッケージ参照: .csproj ファイルに <PackageReference Include="IronPdf" Version="*" /> を追加します -直接ダウンロード: IronPDFのWebサイトからDLLをダウンロードし、手動で参照します。 -コマンドライン: ターミナルでdotnet add package IronPdfを使用します

Azure デプロイメントの場合、追加の構成が必要になる場合があります。 同様に、 Docker 環境には特定のセットアップ手順が必要です。

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

IronPDF は、PDF 変換用のさまざまな画像形式をサポートしています。

• JPEG/JPG : 写真で最も一般的な形式
• PNG : 透明な画像に最適
• GIF : アニメーションGIFを含む(最初のフレームを使用)
• BMP : Windows ビットマップ形式
• TIFF :複数ページのTIFFファイルを含む
• SVG : スケーラブルベクターグラフィック
• WebP : 最新のウェブ画像フォーマット

サンプル画像

ライブラリを使用するには、program.cs ファイルでIronPDFライブラリを参照します。ファイルの先頭に次のコードスニペットを記述します。

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

using IronPdf;
using IronPdf.Imaging;
using System.Linq;

Imports IronPdf
Imports IronPdf.Imaging
Imports System.Linq

次に、メイン関数内に次のコードを書いてください。 これにより、JPG ファイルが PDF ファイルに変換されます。

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);

    // Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial";
    doc.MetaData.Title = "Image to PDF Conversion";
    doc.MetaData.Subject = "Converting JPG to PDF";

    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");

    Console.WriteLine("PDF created successfully!");
}

Public Shared Sub Main(args As String())
    ' Convert a single image to the PDF document
    Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf("D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage)

    ' Optional: Set document properties
    doc.MetaData.Author = "IronPDF Tutorial"
    doc.MetaData.Title = "Image to PDF Conversion"
    doc.MetaData.Subject = "Converting JPG to PDF"

    ' Save the resulting PDF to the specified path
    doc.SaveAs("D:\Iron Software\ImageToPDF\bird.pdf")

    Console.WriteLine("PDF created successfully!")
End Sub

ImageBehavior は出力にどのような影響を与えますか?

上記のコード例では、 IronPDFが提供する ImageToPdfConverter クラスが画像変換に使用されています。 ImageToPdf メソッドを使用して、画像から PDF ドキュメントを作成できます。 入力として、画像ファイルと System.Drawing オブジェクトの両方を受け入れます。

静的メソッド ImageToPdf は、単一の画像ファイルを、寸法が一致する同一の PDF ドキュメントに変換します。 それは2つの引数を取ります：画像のパスと画像の動作(画像の用紙上での表示方法)。 ImageBehavior 列挙型にはいくつかのオプションがあります。

• CropPage : PDF ページ サイズを画像の寸法に合わせて設定します
• CenteredOnPage : 画像をサイズ変更せずにページの中央に配置します
• FitToPage : ページの余白に収まるように画像を拡大縮小します
• FitToPageAndMaintainAspectRatio : アスペクト比を維持しながら拡大縮小します

Imaging.ImageBehavior.CropPage は、用紙サイズを画像サイズと同じに設定します。デフォルトのページサイズはA4です。次のコードで設定できます。

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter

特定の要件に合わせてカスタム ページ サイズを設定することもできます。

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);

' Set custom page size in millimeters
ImageToPdfConverter.PaperSize = New IronPdf.Rendering.PdfPaperSize(210, 297)

どのような用紙サイズのオプションが利用できますか?

複数のページサイズオプションが提供されており、必要に応じて設定することができます。 IronPDF はすべての標準用紙サイズをサポートしています。

• A シリーズ: A0、A1、A2、A3、A4 (デフォルト)、A5、A6、A7、A8、A9、A10
• Bシリーズ：B0からB10
• USサイズ：レター、リーガル、レジャー、タブロイド、エグゼクティブ -その他：フールスキャップ、クラウン、デミー、ロイヤルなど

PDF のページの向き(縦または横) やカスタム余白を設定することもできます。

さまざまな画像形式をフィルタリングするにはどうすればよいですか?

上記のコードでは、System.IO.Directory.EnumerateFiles は指定されたフォルダー内にあるすべてのファイルを取得します。 Where 句は、そのフォルダーからすべての JPG イメージをフィルターし、imageFiles コレクションに保存します。 PNG またはその他の画像形式がある場合は、それを Where クエリに追加するだけです。

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) || 
                f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
                f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));

' Filter multiple image formats
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
    .Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) OrElse _
                      f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase))

拡張機能の配列を使用して、より簡潔なアプローチを使用することもできます。

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
    .Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));

Dim imageExtensions As String() = {".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff"}
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
    .Where(Function(f) imageExtensions.Any(Function(ext) f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))

PDF 内で画像はどのような順序で表示されますか?

デフォルトでは、画像はファイル システムによって返される順序で表示されますが、アルファベット順ではない場合があります。 順序を制御するには、ファイルを並べ替えることができます。

-アルファベット順: imageFiles.OrderBy(f => f) -作成日別: imageFiles.OrderBy(f => new FileInfo(f).CreationTime) -ファイルサイズ別: imageFiles.OrderBy(f => new FileInfo(f).Length) -カスタム順序:カスタム比較関数を使用する

次の行はすべての画像を取り出して、1つのPDFドキュメントに結合します。 各画像は PDF 内で個別のページになります。

プリンターの設定を指定できますか?

PdfDocument クラスによって提供される Print メソッドは、デフォルトのプリンタを使用してドキュメントを印刷します。 また、プリンター名やその他の設定を変更するオプションも提供しています。 高度な印刷オプションについては、以下をご覧ください。

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

// Advanced printing with settings
using System.Drawing.Printing;

var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;

printDocument.Print();

' Advanced printing with settings
Imports System.Drawing.Printing

Dim printDocument = doc.GetPrintDocument()
printDocument.PrinterSettings.PrinterName = "Your Printer Name"
printDocument.PrinterSettings.Copies = 2
printDocument.PrinterSettings.Collate = True
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages
printDocument.PrinterSettings.FromPage = 1
printDocument.PrinterSettings.ToPage = 3

printDocument.Print()

ドキュメントの印刷の詳細については、こちらのPDF 印刷例をご覧ください。 エンタープライズ環境向けのネットワーク印刷オプションを検討することもできます。

IronPDFについてさらに詳しく知るにはどこに行けばいいですか?

IronPDFには複数の便利な機能が提供されています。 以下のリソースをご覧ください:

• 製品の概要についてはIronPDFのホームページをご覧ください
• 詳細なガイドについては包括的なドキュメントを参照してください
• 実用的な使用法についてはコード例をご覧ください
• ステップバイステップの学習のためのチュートリアルを読む
• 技術的な詳細については、 API リファレンスにアクセスしてください
• サポートを受けるにはIronPDFコミュニティに参加してください

具体的な使用例については、以下をご覧ください。

• WebコンテンツのHTMLからPDFへの変換
• 保護のためのPDFセキュリティ機能
• 大規模操作のパフォーマンス最適化
• AzureとAWSのクラウド導入ガイド

IronPDF の料金はいくらですか?

IronPDFはIron Softwareスイートの一部です。 Iron Suite には、Excel 操作用のIronXL 、バーコード生成用のIronBarcode 、テキスト認識用のIronOCR 、Web データ抽出用のIronWebscraperなどの追加の便利な製品が含まれています。 Iron Suiteを購入することで最大250%節約できます。現在、5つの製品を2つの価格で手に入れることができます。 詳細については、ライセンスの詳細ページをご覧ください。

IronPDFは次のものを提供します:

• テスト用の無料開発ライセンス -プロフェッショナルライセンスは749ドルから -ロイヤリティフリーの再配布オプション
• SaaSおよびOEMライセンスが利用可能
• 30日間返金保証
• 1年間の無料サポートとアップデート

試用ライセンスでIronPDF を30 日間無料でお試しいただくか、チーム向けのライセンス オプションをご確認ください。