.NET Core PDF Library

Create C# Project

The latest version of Visual Studio is recommended for creating this .NET project to ensure a smooth user experience. The IronPDF library is also compatible with a .NET Core project. The choice depends on the user, as the installation and use of IronPDF are identical across all .NET Frameworks. Follow the steps below to create a project in Visual Studio.

• Start Visual Studio.
• Click on "Create a new project".

Create a new project in Visual Studio

• Search for "Console" in the search field, and select "Console App" with the C# tag from the search results.

Console App selection

• After that, configure the project name according to your requirements.

Configure this new application

• After that, select the latest version of .NET Framework from the dropdown list. This is recommended. Next, click on the Create button.

.NET Framework selection

The project will now be created. You can also use existing .NET Core projects with IronPDF. First, you need to install the library. The next section shows how to install the library.

Installation of the IronPDF Library

To install the IronPDF library from the command line, run the following command:

Install-Package IronPdf

You can get more information on the IronPDF website and the IronPDF NuGet page.

After installation, you will be able to use it in your .NET project. For more details about installation, visit the IronPDF installation guide.

Code Example

A web page for PDF files

using IronPdf;

var renderer = new ChromePdfRenderer();

// Choose Screen or Print CSS media
renderer.RenderingOptions.CssMediaType = Rendering.PdfCssMediaType.Screen;

// Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1280;

// Set the paper size of the output PDF
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A2;

// Render the URL as PDF
var pdf = renderer.RenderUrlAsPdf("https://www.amazon.com/");

// Save the PDF to a local file
pdf.SaveAs("Amazon.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Choose Screen or Print CSS media
renderer.RenderingOptions.CssMediaType = Rendering.PdfCssMediaType.Screen;

// Set the width of the responsive virtual browser window in pixels
renderer.RenderingOptions.ViewPortWidth = 1280;

// Set the paper size of the output PDF
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A2;

// Render the URL as PDF
var pdf = renderer.RenderUrlAsPdf("https://www.amazon.com/");

// Save the PDF to a local file
pdf.SaveAs("Amazon.pdf");

Simple PDF Creation

using IronPdf;

// Instantiate renderer
var renderer = new IronPdf.ChromePdfRenderer();

// Create a PDF from an HTML string using C#
using var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

/****** Advanced Example with HTML Assets ******/
// Load external html assets: images, CSS, and JavaScript.
// An optional BasePath 'C:\\site\\assets\\' is set as the file location to load assets from
using var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");

// Save the PDF with assets to a file
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Instantiate renderer
var renderer = new IronPdf.ChromePdfRenderer();

// Create a PDF from an HTML string using C#
using var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

/****** Advanced Example with HTML Assets ******/
// Load external html assets: images, CSS, and JavaScript.
// An optional BasePath 'C:\\site\\assets\\' is set as the file location to load assets from
using var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");

// Save the PDF with assets to a file
myAdvancedPdf.SaveAs("html-with-assets.pdf");

Headers & Footers

// Initialize the first page number
renderer.RenderingOptions.FirstPageNumber = 1; // use 2 if a cover page will be appended

// Set header options
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "{url}";
renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica;
renderer.RenderingOptions.TextHeader.FontSize = 12;

// Initialize the first page number
renderer.RenderingOptions.FirstPageNumber = 1; // use 2 if a cover page will be appended

// Set header options
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "{url}";
renderer.RenderingOptions.TextHeader.Font = IronPdf.Font.FontTypes.Helvetica;
renderer.RenderingOptions.TextHeader.FontSize = 12;

The above example demonstrates how to set headers and footers in the PDF file. IronPDF supports repeating headers in the document. IronPDF provides TextHeader and TextFooter properties to set various attributes of text, such as fonts, text position, etc. It can also convert HTML files to PDF files. Everything is straightforward with IronPDF. It can also merge PDF files efficiently, perform webpage-to-PDF conversions, enable automatic page numeration, and create digital signatures for PDFs using IronPDF. Furthermore, it produces PDF files of minimal file size with efficient compression.