How to Convert Image to PDF in C# [Code Example Tutorial]

Which .NET Framework Version Should I Choose?

IronPDF supports a wide range of .NET versions, including .NET Framework 4.6.2+, .NET Core 3.1+, and .NET 5/6/7/8+. For new projects, it's recommended to use the latest LTS (Long Term Support) version of .NET for optimal performance and security updates. The library also works seamlessly on Windows, Linux, and macOS platforms.

Next, install the IronPDF NuGet Package in this project to use its features. The great thing about IronPDF is that it takes the frustration out of generating PDF documents by not relying on proprietary APIs. HTML to PDF rendering renders pixel-perfect PDFs from open standard document types: HTML, JS, CSS, JPG, PNG, GIF, and SVG. In short, it uses the skills that developers already possess.

What Are Alternative Installation Methods?

You can also install IronPDF through:

• NuGet Package Manager UI: Right-click on your project, select "Manage NuGet Packages," search for "IronPdf," and click Install
• Package Reference: Add <PackageReference Include="IronPdf" Version="*" /> to your .csproj file
• Direct Download: Download the DLL from the IronPDF website and reference it manually
• Command Line: Use dotnet add package IronPdf in the terminal

For Azure deployments, you might need additional configuration. Similarly, Docker environments require specific setup steps.

What Image Formats Are Supported?

IronPDF supports a wide variety of image formats for PDF conversion:

• JPEG/JPG: The most common format for photographs
• PNG: Ideal for images with transparency
• GIF: Including animated GIFs (first frame used)
• BMP: Windows bitmap format
• TIFF: Including multi-page TIFF files
• SVG: Scalable vector graphics
• WebP: Modern web image format

The sample image

To use the library, reference the IronPDF library in the program.cs file. Write the following code snippet at the top of the file:

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

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

Next, write the following code inside the main function. This will convert a JPG file to a PDF file:

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!");
}

How Does ImageBehavior Affect the Output?

In the above code example, the ImageToPdfConverter class provided by IronPDF is used for image conversion. The ImageToPdf method can be used to create PDF documents from images. It accepts both image files and a System.Drawing object as input.

The static method ImageToPdf converts a single image file to an identical PDF document of matching dimensions. It takes two arguments: Image Path and Image Behavior (how the image will display on paper). The ImageBehavior enum provides several options:

• CropPage: Sets PDF page size to match image dimensions
• CenteredOnPage: Centers image on page without resizing
• FitToPage: Scales image to fit within page margins
• FitToPageAndMaintainAspectRatio: Scales while preserving aspect ratio

Imaging.ImageBehavior.CropPage will set the paper size equal to the image size. The default page size is A4. You can set it via the following line of code:

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

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

You can also set custom page sizes for specific requirements:

// 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);

What Paper Size Options Are Available?

There are multiple page-size options provided, and you can set them as per your requirements. IronPDF supports all standard paper sizes:

• A Series: A0, A1, A2, A3, A4 (default), A5, A6, A7, A8, A9, A10
• B Series: B0 through B10
• US Sizes: Letter, Legal, Ledger, Tabloid, Executive
• Other: Foolscap, Crown, Demy, Royal, and more

You can also configure page orientation (Portrait or Landscape) and custom margins for your PDFs.

How Can I Filter Different Image Formats?

In the above code, System.IO.Directory.EnumerateFiles retrieves all files available in the specified folder. The Where clause filters all the JPG images from that folder and stores them in the imageFiles collection. If you have PNG or any other image format, you can just add that to the Where query:

// 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));

You can also use a more concise approach with an array of extensions:

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)));

What Order Will Images Appear in the PDF?

By default, images appear in the order returned by the file system, which may not be alphabetical. To control the order, you can sort the files:

• Alphabetical: imageFiles.OrderBy(f => f)
• By Creation Date: imageFiles.OrderBy(f => new FileInfo(f).CreationTime)
• By File Size: imageFiles.OrderBy(f => new FileInfo(f).Length)
• Custom Order: Use a custom comparison function

The next line will take all the images and combine them into a single PDF document. Each image becomes a separate page in the PDF.

Can I Specify Printer Settings?

The Print method provided by the PdfDocument class will print the document using the default printer. It also provides an option to change the printer name and other settings. For advanced printing options:

// 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();

For more details about printing documents, please visit this PDF printing example. You can also explore network printing options for enterprise environments.

Where Can I Learn More About IronPDF?

There are multiple useful features provided by IronPDF. Explore these resources:

• Visit the IronPDF homepage for product overview
• Browse comprehensive documentation for detailed guides
• Check out code examples for practical uses
• Read tutorials for step-by-step learning
• Access the API reference for technical details
• Join the IronPDF community for support

For specific use cases, explore:

• HTML to PDF conversion for web content
• PDF security features for protection
• Performance optimization for large operations
• Cloud deployment guides for Azure and AWS

How Much Does IronPDF Cost?

IronPDF is part of the Iron Software suite. The Iron Suite includes additional useful products such as IronXL for Excel operations, IronBarcode for barcode generation, IronOCR for text recognition, and IronWebscraper for web data extraction. You can save up to 250% by purchasing the complete Iron Suite, as you can currently get all five products for the price of just two. Please visit the licensing details page for more information.

IronPDF offers:

• Free development license for testing
• Professional licenses starting from $749
• Royalty-free redistribution options
• SaaS and OEM licensing available
• 30-day money-back guarantee
• Free support and updates for one year

Try IronPDF free for 30 days with a trial license, or explore licensing options for your team.