What is IronPDF?

1. PDF Generation: Easily create PDF documents programmatically in C# from various sources, including HTML, images, text, and existing files.
2. HTML to PDF Conversion: Convert HTML content into PDFs, including web pages or HTML templates, into high-quality PDFs with full control over styling and formatting.
3. Image to PDF Conversion: Convert image files (such as JPEG, PNG, or BMP) into PDF documents, allowing for easy integration of images into PDF reports and documents.
4. PDF Manipulation: Comprehensive PDF editing capabilities, including text extraction from PDFs, merging and splitting PDFs, and rotation, as well as adding, modifying, or removing content and annotations.
5. PDF Forms: Create, fill, and extract data from PDF forms, making it suitable for applications that require interactive forms and data collection.

Whether you need to generate PDFs from scratch, convert HTML pages, images, or existing documents into PDF format, or manipulate existing PDFs, IronPDF offers straightforward APIs to accomplish these tasks. The library uses a Chrome rendering engine to ensure your HTML conversions look exactly as they should. For a complete list of capabilities, check out the IronPDF Features Overview website.

1. PDF Generation: Create PDFs programmatically from HTML, images, text, and files. Supports custom sizes, orientation, and margins. Handles international languages too.
2. HTML to PDF Conversion: Convert HTML to PDF with full styling. Supports CSS media, JavaScript, and web fonts. Works with WebGL and responsive designs.
3. Image to PDF Conversion: Convert JPEG, PNG, or BMP files to PDF. Supports TIFF conversion and SVG graphics. Can embed images with DataURIs.
4. PDF Manipulation: Edit PDFs with text extraction, merging/splitting, and annotations. Also redact text, add stamps, and manage metadata.
5. PDF Forms: Create and fill PDF forms. Supports creating and editing forms. Can flatten PDFs to static content.

How Do I Create a New Visual Studio Project?

Before diving into code, let's set up a new C# Console Application project. If you're new to .NET development, you might find the quickstart guide helpful for additional setup tips. F# developers can also use IronPDF with functional programming approaches.

1. Open Visual Studio and create a new project by clicking File > New > Project.

   The File menu in Visual Studio provides quick access to essential project management functions, from creating new projects to cloning repositories from version control systems.

2. A new window appears. Select the Console Application template and click Next at the bottom. This template is perfect for learning PDF basics before moving to complex project types like Blazor applications or ASP.NET MVC.

   The Console Application template in Visual Studio provides a starting point for creating cross-platform command-line applications using .NET Core.

3. In the next window, name your project and choose a location, then click Next. Consider organizing projects in a dedicated folder for easy access to code examples and sample files.

   Step 2: Configuring the new Console Application project with appropriate naming and location settings for the PDF conversion application.

4. Select your target framework and click Create. For modern applications, use .NET 6 or later for best performance and support. Recent versions offer improved performance and async capabilities.

   The final step in creating a new Console Application in Visual Studio, where you select the target framework. Note that .NET 5.0 is marked as 'Out of support' - consider using .NET 6.0 or .NET 8.0 for current projects.

Your project is ready. Let's install IronPDF.

How Do I Install IronPDF?

IronPDF offers several installation methods. We'll use the NuGet Package Manager here. You can explore advanced installation methods for specific scenarios, including Windows Installer options and Linux configurations.

1. In Visual Studio, open the Tools menu and hover over NuGet Package Manager.

2. Click Manage NuGet Packages for Solutions.

   The Tools menu in Visual Studio provides access to NuGet Package Manager features, which are essential for managing external libraries and dependencies in .NET projects

3. A new window appears. Click the Browse tab and search for "IronPDF".
4. Select IronPDF and click Install. For smaller deployments, consider IronPdf.Slim.

5. You can also install via Package Manager Console:

   Install-Package IronPdf

Or download directly from the IronPDF NuGet page. For containers, see the Docker deployment guide or run IronPDF as a remote container.

How Do I Convert Files to PDF Using IronPDF?

Let's explore converting different document formats to PDF. IronPDF provides extensive rendering options for customizing output, including custom logging and performance monitoring.

1. HTML Files to PDF Documents
2. Image to PDF Documents

using IronPdf;

// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();

// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;

// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";

// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;

// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");

// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");

// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");

using IronPdf;

// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();

// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;

// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";

// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;

// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");

// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");

// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));

// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();

// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;

// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);

// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale

// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");

// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");

// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");

using IronPdf;
using System.IO;
using System.Linq;

// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));

// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();

// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;

// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);

// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale

// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");

// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");

// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");

What Advanced PDF Conversion Features Are Available?

Beyond basic HTML and image conversion, IronPDF offers many advanced features for comprehensive PDF work. The library supports async operations and parallel processing for high-performance scenarios.

What Are the Key Takeaways?

This article explored PDF conversion in C# for document management and sharing. With C# and IronPDF, you can easily integrate PDF functionality into your applications. From generating PDFs to converting HTML, images, and existing documents, IronPDF offers comprehensive capabilities. The code examples showed how to convert both HTML documents and images to PDFs with minimal effort.

IronPDF's strength lies in its comprehensive features:

• Cross-platform support for Windows, Linux, macOS, and cloud
• Multiple conversion formats including HTML, images, DOCX, RTF, and more
• Advanced features like digital signatures, encryption, forms, and annotations
• Performance optimization through async operations and parallel processing
• Pixel-perfect rendering using the Chrome rendering engine
• Comprehensive documentation with API reference and troubleshooting guides

As shown, IronPDF simplifies complex PDF tasks, making it valuable for developers enhancing document processing in .NET applications. Whether building web applications, desktop software, or cloud services, IronPDF provides the tools for professional PDF generation. The library's feature set includes creating, editing, converting, and securing PDF documents.

To download the PDF conversion library, visit the NuGet package for IronPDF. Also, check out the HTML-to-PDF conversion tutorial with IronPDF. For hands-on learning, explore our code examples and comprehensive tutorials. IronPDF developers can choose from various licenses to suit their needs. A free trial is available. For complete pricing and licensing information, visit the IronPDF Licensing Information page. Check the changelog for latest updates and improvements.