ASP.NET C# and VB code samples

PDF Generation Settings

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();

Renderer.PrintOptions.SetCustomPaperSizeInInches(12.5, 20);
Renderer.PrintOptions.PrintHtmlBackgrounds = true;
Renderer.PrintOptions.PaperOrientation = PdfPrintOptions.PdfPaperOrientation.Portrait;
Renderer.PrintOptions.Title = "My PDF Document Name";
Renderer.PrintOptions.EnableJavaScript = true;
Renderer.PrintOptions.RenderDelay = 50; //ms
Renderer.PrintOptions.CssMediaType = PdfPrintOptions.PdfCssMediaType.Screen;
Renderer.PrintOptions.DPI = 300;
Renderer.PrintOptions.FitToPaperWidth = true;
Renderer.PrintOptions.JpegQuality = 80;
Renderer.PrintOptions.GrayScale = false;
Renderer.PrintOptions.FitToPaperWidth = true;
Renderer.PrintOptions.InputEncoding = Encoding.UTF8;
Renderer.PrintOptions.Zoom = 100;
Renderer.PrintOptions.CreatePdfFormsFromHtml = true;

Renderer.PrintOptions.MarginTop = 40;  //millimeters
Renderer.PrintOptions.MarginLeft = 20;  //millimeters
Renderer.PrintOptions.MarginRight = 20;  //millimeters
Renderer.PrintOptions.MarginBottom = 40;  //millimeters

Renderer.PrintOptions.FirstPageNumber = 1; //use 2 if a coverpage  will be appended

Renderer.RenderHTMLFileAsPdf("my-content.html").SaveAs("my-content.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Renderer As New IronPdf.HtmlToPdf()

Renderer.PrintOptions.SetCustomPaperSizeInInches(12.5, 20)
Renderer.PrintOptions.PrintHtmlBackgrounds = True
Renderer.PrintOptions.PaperOrientation = PdfPrintOptions.PdfPaperOrientation.Portrait
Renderer.PrintOptions.Title = "My PDF Document Name"
Renderer.PrintOptions.EnableJavaScript = True
Renderer.PrintOptions.RenderDelay = 50 'ms
Renderer.PrintOptions.CssMediaType = PdfPrintOptions.PdfCssMediaType.Screen
Renderer.PrintOptions.DPI = 300
Renderer.PrintOptions.FitToPaperWidth = True
Renderer.PrintOptions.JpegQuality = 80
Renderer.PrintOptions.GrayScale = False
Renderer.PrintOptions.FitToPaperWidth = True
Renderer.PrintOptions.InputEncoding = Encoding.UTF8
Renderer.PrintOptions.Zoom = 100
Renderer.PrintOptions.CreatePdfFormsFromHtml = True

Renderer.PrintOptions.MarginTop = 40 'millimeters
Renderer.PrintOptions.MarginLeft = 20 'millimeters
Renderer.PrintOptions.MarginRight = 20 'millimeters
Renderer.PrintOptions.MarginBottom = 40 'millimeters

Renderer.PrintOptions.FirstPageNumber = 1 'use 2 if a coverpage  will be appended

Renderer.RenderHTMLFileAsPdf("my-content.html").SaveAs("my-content.pdf")

IronPDF supports many customizations for generated PDF file formats including: Paper Sizes, Document output quality, Content Scaling, CSS 'media types' and JavaScript Support.

Using Html To Create a PDF

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

var Renderer = new IronPdf.HtmlToPdf();
Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>").SaveAs("example.pdf");

 


// Advanced:  Load external html assets: images, css and javascript.
// An optional "base" asset locating path can be set as a url or local directory. 
var PDF = Renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
PDF.SaveAs("html-with-assets.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Renderer = New IronPdf.HtmlToPdf()
Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>").SaveAs("example.pdf")




' Advanced:  Load external html assets: images, css and javascript.
' An optional "base" asset locating path can be set as a url or local directory. 
Dim PDF = Renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")
PDF.SaveAs("html-with-assets.pdf")

IronPDF allows developers to create PDF documents easily in C#, F#, and VB.Net for .NET Core and .NET Framework. In this example we show that a PDF document can be rendered using HTML. You can choose simple HTML like the above, or incorporate CSS, images and Javascript. IronPDF rendering closely follows Google Chrome.

Converting a URL to a PDF

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();
Renderer.RenderUrlAsPdf("https://ironpdf.com/").SaveAs("url.pdf");



// or System.IO.MemoryStream PdfStream = PDF.GetStream;
// or byte[] PdfBinary = PDF.GetBinary;

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Renderer As New IronPdf.HtmlToPdf()
Renderer.RenderUrlAsPdf("https://ironpdf.com/").SaveAs("url.pdf")



' or System.IO.MemoryStream PdfStream = PDF.GetStream;
' or byte[] PdfBinary = PDF.GetBinary;

IronPDF makes it very straightforward to render HTML from existing URLs as PDF documents. There is a very high level of support for Javascript, Images, Forms and CSS.

Rendering PDFs from ASP.NET URLs which accept query string variables can make PDF development an easy collaboration between designers and coders.

Rendering ASPX Pages as PDFs

private void Form1_Load(object sender, EventArgs e)
{
IronPdf.AspxToPdf.RenderThisPageAsPdf();
//Changes the ASPX output into a pdf instead of html
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
IronPdf.AspxToPdf.RenderThisPageAsPdf()
'Changes the ASPX output into a pdf instead of html
End Sub

Using the IronPDF library, ASP.NET web pages can be rendered to PDF instead of HTML by adding a single line of code to the Form_Load event. This allows complex PDFs to be data driven, and designed and tested as HTML first for simplicity.

HTML or Image File to PDF

 // Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

// Create a PDF from an existing HTML using C#
 var Renderer = new IronPdf.HtmlToPdf();
 var PDF = Renderer.RenderHTMLFileAsPdf("Assets/TestInvoice1.html");
 var OutputPath = "Invoice.pdf";
 PDF.SaveAs(OutputPath);

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

' Create a PDF from an existing HTML using C#
 Private Renderer = New IronPdf.HtmlToPdf()
 Private PDF = Renderer.RenderHTMLFileAsPdf("Assets/TestInvoice1.html")
 Private OutputPath = "Invoice.pdf"
 PDF.SaveAs(OutputPath)

We can also render any HTML file on our hard disk.

All relative assets such as CSS, images and js will be rendered as if the file had been opened using the file:// protocol.

This method has the advantage of allowing the developer the opportunity to test the HTML content in a browser during development. We recommend Chrome as being the web browser on which IronPDF's rendering engine is based.

ASPX To PDF Settings

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

private void Form1_Load(object sender, EventArgs e)
{
    PdfPrintOptions PdfOptions = new PdfPrintOptions()
    {
        DPI = 300,
        EnableJavaScript = false,
        //.. many more options available
    };

AspxToPdf.RenderThisPageAsPDF(AspxToPdf.FileBehaviour.Attachment,"MyPdfFile.pdf", PdfOptions);
}

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
	Dim PdfOptions As New PdfPrintOptions() With {
		.DPI = 300,
		.EnableJavaScript = False
	}

AspxToPdf.RenderThisPageAsPDF(AspxToPdf.FileBehaviour.Attachment,"MyPdfFile.pdf", PdfOptions)
End Sub

ASP.NET ASPX to PDF functionality allows the full set of options available when rendering HTML from a string or file, but adds 2 new options:
- Changing the PDF file name
- Your PDF may be displayed directly in the web browser, or as a file download.

Image To PDF

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;
using System.IO;
using System.Linq;

// Select one or more images.  This example selects all JPEG images in a specific folder.
var ImageFiles = Directory.EnumerateFiles(@"C:\project\assets").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert the images to a PDF and save it.
ImageToPdfConverter.ImageToPdf(ImageFiles).SaveAs(@"C:\project\composite.pdf");
            
//Also see PdfDocument.RasterizeToImageFiles() method to flatten a PDF to images or thumbnails

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf
Imports System.IO
Imports System.Linq

' Select one or more images.  This example selects all JPEG images in a specific folder.
Private ImageFiles = Directory.EnumerateFiles("C:\project\assets").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert the images to a PDF and save it.
ImageToPdfConverter.ImageToPdf(ImageFiles).SaveAs("C:\project\composite.pdf")

'Also see PdfDocument.RasterizeToImageFiles() method to flatten a PDF to images or thumbnails

PDF documents can be easily constructed from one or more image files using the IronPdf.ImageToPdfConverter Class.

Headers & Footers

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();

// add a header to every page easily
Renderer.PrintOptions.FirstPageNumber = 1; // use 2 if a coverpage  will be appended
Renderer.PrintOptions.Header.DrawDividerLine = true;
Renderer.PrintOptions.Header.CenterText = "{url}" ;
Renderer.PrintOptions.Header.FontFamily = "Helvetica,Arial";
Renderer.PrintOptions.Header.FontSize = 12;

// add a footer too
Renderer.PrintOptions.Footer.DrawDividerLine = true;
Renderer.PrintOptions.Footer.FontFamily = "Arial";
Renderer.PrintOptions.Footer.FontSize = 10;
Renderer.PrintOptions.Footer.LeftText = "{date} {time}";
Renderer.PrintOptions.Footer.RightText = "{page} of {total-pages}";

// mergable fields are:
// {page} {total-pages} {url} {date} {time} {html-title} & {pdf-title}

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Renderer As New IronPdf.HtmlToPdf()

' add a header to every page easily
Renderer.PrintOptions.FirstPageNumber = 1 ' use 2 if a coverpage  will be appended
Renderer.PrintOptions.Header.DrawDividerLine = True
Renderer.PrintOptions.Header.CenterText = "{url}"
Renderer.PrintOptions.Header.FontFamily = "Helvetica,Arial"
Renderer.PrintOptions.Header.FontSize = 12

' add a footer too
Renderer.PrintOptions.Footer.DrawDividerLine = True
Renderer.PrintOptions.Footer.FontFamily = "Arial"
Renderer.PrintOptions.Footer.FontSize = 10
Renderer.PrintOptions.Footer.LeftText = "{date} {time}"
Renderer.PrintOptions.Footer.RightText = "{page} of {total-pages}"

' mergable fields are:
' {page} {total-pages} {url} {date} {time} {html-title} & {pdf-title}

Headers and Footers may be added to PDF documents in 2 distinct ways.
- SimpleHeaderFooter allows text based headers to be added, with the option to merge in dynamic data.
- HtmlHeaderFooter allows the developer to render HTML headers and footers to PDF files, also allowing the templating of dynamic data.

HTML Headers & Footers

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();


// Build a footer using html to style the text
// mergable fields are:
// {page} {total-pages} {url} {date} {time} {html-title} & {pdf-title}
Renderer.PrintOptions.Footer = new HtmlHeaderFooter()
{
  Height = 15,
  HtmlFragment = "<center><i>{page} of {total-pages}<i></center>",
  DrawDividerLine = true
 };

// Build a header using an image asset
// Note the use of BaseUrl to set a relative path to the assets
Renderer.PrintOptions.Header = new HtmlHeaderFooter()
{
  Height = 20,
  HtmlFragment = "<img src='logo.png'>",
  BaseUrl = new Uri(@"C:\assets\images\").AbsoluteUri
};

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

Private Renderer As New IronPdf.HtmlToPdf()


' Build a footer using html to style the text
' mergable fields are:
' {page} {total-pages} {url} {date} {time} {html-title} & {pdf-title}
Renderer.PrintOptions.Footer = New HtmlHeaderFooter() With {
	.Height = 15,
	.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>",
	.DrawDividerLine = True
}

' Build a header using an image asset
' Note the use of BaseUrl to set a relative path to the assets
Renderer.PrintOptions.Header = New HtmlHeaderFooter() With {
	.Height = 20,
	.HtmlFragment = "<img src='logo.png'>",
	.BaseUrl = (New Uri("C:\assets\images\")).AbsoluteUri
}

HTML Headers and Footers are rendered as independent HTML documents which may have their own assets and stylesheets. Developers may control the Height of the rendered Header or Footer to match their content exactly.

Form Data

           
// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

// Step 1.  Creating a PDF with editable forms from HTML using form and input tags

var FormHtml = @"
<html>
    <body>
        <h2>Editable PDF  Form</h2>
        <form>
          First name:<br> <input type='text' name='firstname' value=''   > <br>
          Last name:<br> <input type='text' name='lastname'  value='' >
        </form>
    </body>
</html>";

IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();
Renderer.PrintOptions.CreatePdfFormsFromHtml = true;
Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("BasicForm.pdf");

// Step 2. Reading and Writing PDF form values.
var FormDocument = PdfDocument.FromFile("BasicForm.pdf");

//Set and Read the value of the "firstname" field
var FirstNameField =  FormDocument.Form.GetFieldByName("firstname");
FirstNameField.Value = "Minnie";
Console.WriteLine("FirstNameField value: {0}", FirstNameField.Value);

//Set and Read the value of the "lastname" field
IronPdf.Forms.FormField LastNameField = FormDocument.Form.GetFieldByName("lastname");
LastNameField.Value = "Mouse";
Console.WriteLine("LastNameField value: {0}", LastNameField.Value);

FormDocument.SaveAs("FilledForm.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

' Step 1.  Creating a PDF with editable forms from HTML using form and input tags

Private FormHtml = "
<html>
    <body>
        <h2>Editable PDF  Form</h2>
        <form>
          First name:<br> <input type='text' name='firstname' value=''   > <br>
          Last name:<br> <input type='text' name='lastname'  value='' >
        </form>
    </body>
</html>"

Private Renderer As New IronPdf.HtmlToPdf()
Renderer.PrintOptions.CreatePdfFormsFromHtml = True
Renderer.RenderHtmlAsPdf(FormHtml).SaveAs("BasicForm.pdf")

' Step 2. Reading and Writing PDF form values.
Dim FormDocument = PdfDocument.FromFile("BasicForm.pdf")

'Set and Read the value of the "firstname" field
Dim FirstNameField = FormDocument.Form.GetFieldByName("firstname")
FirstNameField.Value = "Minnie"
Console.WriteLine("FirstNameField value: {0}", FirstNameField.Value)

'Set and Read the value of the "lastname" field
Dim LastNameField As IronPdf.Forms.FormField = FormDocument.Form.GetFieldByName("lastname")
LastNameField.Value = "Mouse"
Console.WriteLine("LastNameField value: {0}", LastNameField.Value)

FormDocument.SaveAs("FilledForm.pdf")

PDFs with editable forms can be created from HTML simply by adding <form>, <input>, and <textarea> tags. The PdfDocument.Form.GetFieldByName can be used to read and write the value of any form field. The name of the field will be the same as the 'name' attribute given to that field in your HTML. The PdfDocument.Form object can be used to:
- Populate the default value of form fields (must be focused in Adobe Reader to display this value)
- Read data from user filled PDF forms in any language.

Rasterize a PDF to Images

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;
using System.Drawing;


//Example rendering PDF documents to Images or Thumbnails

var pdf = PdfDocument.FromFile("Example.pdf");

//Extract all pages to a folder as image files
 pdf.RasterizeToImageFiles(@"C:\image\folder\*.png");

//Dimensions and page ranges may be specified
 pdf.RasterizeToImageFiles(@"C:\image\folder\thumbnail_*.jpg", 100,80);


//Extract all pages as System.Drawing.Bitmap objects
Bitmap[] pageImages = pdf.ToBitmap();

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf
Imports System.Drawing


'Example rendering PDF documents to Images or Thumbnails

Private pdf = PdfDocument.FromFile("Example.pdf")

'Extract all pages to a folder as image files
 pdf.RasterizeToImageFiles("C:\image\folder\*.png")

'Dimensions and page ranges may be specified
 pdf.RasterizeToImageFiles("C:\image\folder\thumbnail_*.jpg", 100,80)


'Extract all pages as System.Drawing.Bitmap objects
Dim pageImages() As Bitmap = pdf.ToBitmap()

IronPDF allows any PDF document to be exported to image files in convenient formats or Bitmap objects. Image dimensions and page number ranges may also be specified.

Digitally Sign a PDF

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

//The quickest way to cryptographically sign an existing PDF a digital certificate
new IronPdf.PdfSignature("Iron.p12", "123456").SignPdfFile("any.pdf");
// All done in 1 line of code!



//Advanced example for more control

// Step 1. Create a PDF
IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();
PdfDocument doc = Renderer.RenderHtmlAsPdf("<h1>Testing 2048 bit digital security</h1>");

// Step 2. Create a Signature.
// You may create a .pfx or .p12 PDF signing certificate using Adobe Acrobat Reader. 
// Read: https://helpx.adobe.com/acrobat/using/digital-ids.html
var signature = new IronPdf.PdfSignature("Iron.pfx", "123456");

// Step 3. Optional signing options and a handwritten signature graphic
signature.SigningContact = "support@ironsoftware.com";
signature.SigningLocation = "Chicago, USA";
signature.SigningReason = "To show how to sign a PDF";
signature.LoadSignatureImageFromFile("handwriting.png");

//Step 4. Sign the PDF with the PdfSignature. Multiple signing certificates may be used
doc.SignPdfWithDigitalSignature(signature);

//Step 4. The PDF is not signed until saved to file, steam or byte array.
doc.SaveAs("signed.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

'The quickest way to cryptographically sign an existing PDF a digital certificate
Call (New IronPdf.PdfSignature("Iron.p12", "123456")).SignPdfFile("any.pdf")
' All done in 1 line of code!



'Advanced example for more control

' Step 1. Create a PDF
Dim Renderer As New IronPdf.HtmlToPdf()
Dim doc As PdfDocument = Renderer.RenderHtmlAsPdf("<h1>Testing 2048 bit digital security</h1>")

' Step 2. Create a Signature.
' You may create a .pfx or .p12 PDF signing certificate using Adobe Acrobat Reader. 
' Read: https://helpx.adobe.com/acrobat/using/digital-ids.html
Dim signature = New IronPdf.PdfSignature("Iron.pfx", "123456")

' Step 3. Optional signing options and a handwritten signature graphic
signature.SigningContact = "support@ironsoftware.com"
signature.SigningLocation = "Chicago, USA"
signature.SigningReason = "To show how to sign a PDF"
signature.LoadSignatureImageFromFile("handwriting.png")

'Step 4. Sign the PDF with the PdfSignature. Multiple signing certificates may be used
doc.SignPdfWithDigitalSignature(signature)

'Step 4. The PDF is not signed until saved to file, steam or byte array.
doc.SaveAs("signed.pdf")

IronPDF has options to digitally sign new or existing PDF files using .pfx and .p12 X509Certificate2 digital certificates.

Once a PDF is signed, it can not be modified without the certificate being invalidated. This ensures fidelity.

To generate a signing certificate for free using Adobe Reader, please read https://helpx.adobe.com/acrobat/using/digital-ids.html

In addition to cryptographic signing, a hand written signature image or company stamp image may also be used to sign using IronPDF.

Editing PDFs

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;
using System.Collections.Generic;

var Renderer = new IronPdf.HtmlToPdf();

// Join Multiple Existing PDFs into a single document
var PDFs     = new List<PdfDocument>();
PDFs.Add(PdfDocument.FromFile("A.pdf"));
PDFs.Add(PdfDocument.FromFile("B.pdf"));
PDFs.Add(PdfDocument.FromFile("C.pdf"));
PdfDocument PDF =  PdfDocument.Merge(PDFs);
PDF.SaveAs("merged.pdf");

// Add a cover page
PDF.PrependPdf(Renderer.RenderHtmlAsPdf("<h1>Cover Page</h1><hr>"));

// Remove the last page from the PDF and save again
PDF.RemovePage(PDF.PageCount - 1);
PDF.SaveAs("merged.pdf");

// Copy pages 5-7 and save them as a new document.
PDF.CopyPages(4,6).SaveAs("exerpt.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf
Imports System.Collections.Generic

Private Renderer = New IronPdf.HtmlToPdf()

' Join Multiple Existing PDFs into a single document
Private PDFs = New List(Of PdfDocument)()
PDFs.Add(PdfDocument.FromFile("A.pdf"))
PDFs.Add(PdfDocument.FromFile("B.pdf"))
PDFs.Add(PdfDocument.FromFile("C.pdf"))
Dim PDF As PdfDocument = PdfDocument.Merge(PDFs)
PDF.SaveAs("merged.pdf")

' Add a cover page
PDF.PrependPdf(Renderer.RenderHtmlAsPdf("<h1>Cover Page</h1><hr>"))

' Remove the last page from the PDF and save again
PDF.RemovePage(PDF.PageCount - 1)
PDF.SaveAs("merged.pdf")

' Copy pages 5-7 and save them as a new document.
PDF.CopyPages(4,6).SaveAs("exerpt.pdf")

IronPDF allows many PDF file editing manipulations. The most popular are merging, cloning and extracting pages.

PDF may also be watermarked, stamped and have backgrounds and foregrounds applied.

Passwords, Security and MetaData

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;
 


//Open an Encrypted File, alternatively create a new PDF from Html

PdfDocument Pdf = PdfDocument.FromFile("encrypted.pdf", "password");

//Edit file metadata
Pdf.MetaData.Author = "Satoshi Nakamoto";
Pdf.MetaData.Keywords = "SEO, Friendly";
Pdf.MetaData.ModifiedDate = DateTime.Now;

//Edit file security settings

//The following code makes a PDF read only and will disallow copy & paste and printing
Pdf.SecuritySettings.RemovePasswordsAndEncryption();
Pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key");
Pdf.SecuritySettings.AllowUserAnnotations = false;
Pdf.SecuritySettings.AllowUserCopyPasteContent = false;
Pdf.SecuritySettings.AllowUserFormData = false;
Pdf.SecuritySettings.AllowUserPrinting =  PdfDocument.PdfSecuritySettings.PdfPrintSecrity.FullPrintRights;



//Change or set the document ecrpytion password
ExistingPdf.Password = "my-password";
Pdf.SaveAs("secured.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf



'Open an Encrypted File, alternatively create a new PDF from Html

Private Pdf As PdfDocument = PdfDocument.FromFile("encrypted.pdf", "password")

'Edit file metadata
Pdf.MetaData.Author = "Satoshi Nakamoto"
Pdf.MetaData.Keywords = "SEO, Friendly"
Pdf.MetaData.ModifiedDate = Date.Now

'Edit file security settings

'The following code makes a PDF read only and will disallow copy & paste and printing
Pdf.SecuritySettings.RemovePasswordsAndEncryption()
Pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key")
Pdf.SecuritySettings.AllowUserAnnotations = False
Pdf.SecuritySettings.AllowUserCopyPasteContent = False
Pdf.SecuritySettings.AllowUserFormData = False
Pdf.SecuritySettings.AllowUserPrinting = PdfDocument.PdfSecuritySettings.PdfPrintSecrity.FullPrintRights



'Change or set the document ecrpytion password
ExistingPdf.Password = "my-password"
Pdf.SaveAs("secured.pdf")

Granular meta-data and security settings can be applied. This now includes the ability to limit PDF documents to be unprintable, read only and encrypted. 128 bit encryption, decryption and password protection of PDF documents is supported.

PDF Watermarking

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

// Stamps a watermark onto a new or existing PDF
IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();
var pdf =  Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");
pdf.WatermarkAllPages("<h2 style='color:red'>SAMPLE</h2>", PdfDocument.WaterMarkLocation.MiddleCenter, 50, -45, "https://www.nuget.org/packages/IronPdf");
pdf.SaveAs(@"C:\Path\To\Watermarked.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

' Stamps a watermark onto a new or existing PDF
Private Renderer As New IronPdf.HtmlToPdf()
Private pdf = Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf")
pdf.WatermarkAllPages("<h2 style='color:red'>SAMPLE</h2>", PdfDocument.WaterMarkLocation.MiddleCenter, 50, -45, "https://www.nuget.org/packages/IronPdf")
pdf.SaveAs("C:\Path\To\Watermarked.pdf")

IronPDF provides methods to 'watermark' PDF documents with HTML. Watermarks may be set to render above or below existing content, and have built in capacity for opacity, rotation and hyperlinks.

Backgrounds & Foregrounds

// Install IronPdf with Nuget:  PM> Install-Package IronPdf
using IronPdf;

// With IronPDF, we can easily merge 2 PDF files using one as a backgorund or foreground
IronPdf.HtmlToPdf Renderer = new IronPdf.HtmlToPdf();
var pdf =  Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");
pdf.AddBackgroundPdf(@"MyBackground.pdf");
pdf.AddForegroundOverlayPdfToPage (0, @"MyForeground.pdf", 0);
pdf.SaveAs(@"C:\Path\To\Complete.pdf");

' Install IronPdf with Nuget:  PM> Install-Package IronPdf
Imports IronPdf

' With IronPDF, we can easily merge 2 PDF files using one as a backgorund or foreground
Private Renderer As New IronPdf.HtmlToPdf()
Private pdf = Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf")
pdf.AddBackgroundPdf("MyBackground.pdf")
pdf.AddForegroundOverlayPdfToPage(0, "MyForeground.pdf", 0)
pdf.SaveAs("C:\Path\To\Complete.pdf")

An existing or rendered PDF may be used as the Background or Foreground for another PDF document. This is particularly useful for design consistency and templating.

Human Support Directly From Our .Net Development Team

Whether it's product, integration or licensing queries, the Iron product development team is on hand to support all of your questions. Get in touch and start a dialog with Iron to make the most of our library in your project.

Ask a Question

C# & VB HTML to PDF .Net Library

IronPDF uses a .Net Chromium engine to render HTML pages to PDF files. There's no need to use complex APIs to position or design PDFs: IronPDF supports standard web documents HTML, ASPX, JS, CSS and Images.

Read the How-To Tutorials

Extract and Re-use PDF Text and Images

IronPDF allows you to automatically read content from PDFs for injection into your C# & .NET applications and date storage solutions. Import, migrate and index content from legacy PDF document storage into your document management and business process applications.

Read The Object Reference

Elegant Tools to Edit PDF Documents in .Net

From merging, to splitting, to editing PDFs, use your development skills to output exactly the right PDF at the right time. IronPDF puts a growing array of feature sets directly into your hands, inside your C# / VB.Net Project.

Clear Documentation

Convert HTML5, JS, CSS and Image files to PDF documents using .Net Code.

Works With Documents You Already have

Point IronPDF at your existing HTML, ASPX forms, MVC views and image files to convert directly to PDF. This utilizes your existing assets and web pages to render your data in PDF format.

For ASP.Net, C#, VB, MVC, ASPX, .Net, .NET Core

Get to Hello-World in 5 minutes

Visual Studio Library for PDF Creation and Content Editing.

Rapid Installation With Microsoft Visual Studio

IronPDF puts PDF generation and manipulation tools in your own hands quickly with fully intellisense support and a Visual Studio installer. Whether installing directly from NuGet with Visual Studio or downloading the DLL, you'll be set up in no time. Just one DLL and no dependencies.

PM > Install-Package IronPdf Download DLL

Supports:

Licensing & Pricing

Free community development licenses. Commercial licenses from $399.

Project

Developer

Organization

Agency

SaaS

OEM

View Full License Options

C# PDF Tutorials From Our Community

Tutorial + Code Examples ASPX to PDF | ASP.NET Tutorial

C# PDF ASP.NET ASPX

Jacob Müller Software Product Designer @ Team Iron

ASPX to PDF | ASP.NET Tutorial

Learn how to turn any ASP.Net ASPX page into a PDF document into a PDF instead of HTML using a single line of code in C# or VB.Net…

View Jacob's ASPX-To-PDF Example

Tutorial + Code Examples C# HTML to PDF | C Sharp & VB.Net Tutorial

C# PDF HTML

C# HTML to PDF | C Sharp & VB.Net Tutorial

For many this is the most efficient way to generate PDF files from .Net, because there is no additional API to learn, or complex design system to navigate…

See Jean's HTML-To-PDF Examples