Convert ASPX Pages to PDF in C# ASP.NET

When should I install via DLL instead of NuGet?

Alternatively, download the IronPDF DLL and manually install it to the project or GAC from Download IronPDF Package. For Windows-specific installations, see our Windows installation guide.

Remember to add this statement to the top of any cs class file using IronPDF:

using IronPdf;

using IronPdf;

How do I control PDF display behavior?

"InBrowser" file behavior attempts to show the PDF directly in the user's browser. This is a common feature of modern, standards-compliant browsers.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

"Attachment" file behavior causes the PDF to be downloaded.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

How do I customize the PDF filename?

Set the PDF document filename by adding an additional parameter. This controls the filename when users download or save the file.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

What PDF print options can I configure?

Control PDF output by adding an instance of the IronPdf.ChromePdfRenderer Class. ChromePdfRenderer API Reference

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs

var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
{
    EnableJavaScript = false,
    //.. many more options available
};
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);

The PDF rendering options available include:

• CreatePdfFormsFromHtml: Turns ASPX forms into editable PDF forms. See creating PDF forms.
• CssMediaType: Screen or Print CSS Styles. See comparison images.
• CustomCssUrl: Apply custom CSS to HTML before rendering. Local file path or remote URL.
• EnableMathematicalLaTex: Enable/disable LaTeX element rendering.
• EnableJavaScript: Execute JavaScript before rendering. Ideal for Ajax/Angular apps. See WaitFor guide.
• Javascript: Custom JavaScript to execute after HTML loads but before rendering.
• JavascriptMessageListener: Callback for browser JavaScript console messages.
• FirstPageNumber: Starting page number for headers/footers. Default is 1.
• TableOfContents: Generate TOC at element with id "ironpdf-toc". See TOC guide.
• TextHeader: Set header content as text. Supports mail-merge and auto-linking URLs.
• TextFooter: Set footer content as text. Supports mail-merge and auto-linking URLs.
• HtmlHeader: Set header content using HTML.
• HtmlFooter: Set footer content using HTML.
• MarginBottom: Bottom margin in millimeters. Zero for borderless.
• MarginLeft: Left margin in millimeters. Zero for borderless.
• MarginRight: Right margin in millimeters. Zero for borderless.
• MarginTop: Top margin in millimeters. Zero for borderless.
• UseMarginsOnHeaderAndFooter: Use main document margins for headers/footers.
• PaperFit: Virtual paper layout manager. Includes options for Chrome behavior, zoom, responsive CSS3, scale-to-page, and continuous feed. See viewport guide.
• PaperOrientation: PDF orientation - Landscape or Portrait.
• PageRotation: Rotate pages from existing document. See orientation examples.
• PaperSize: Output paper size using System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters: Set paper size in centimeters.
• SetCustomPaperSizeInInches: Set paper size in inches.
• SetCustomPaperSizeinMilimeters: Set paper size in millimeters.
• SetCustomPaperSizeinPixelsOrPoints: Set paper size in pixels or points.
• ForcePaperSize: Force exact paper size by resizing after generation.
• PrintHtmlBackgrounds: Print HTML image backgrounds.
• GrayScale: Output grayscale PDF. See grayscale conversion.
• WaitFor: Configuration for wait mechanisms:
  • PageLoad: Default render without waiting.
  • RenderDelay: Arbitrary wait time.
  • Fonts: Wait for fonts to load.
  • JavaScript: Trigger render with JavaScript function.
  • HTML elements: Wait for specific elements by ID, name, tag, or selector.
  • NetworkIdle: Wait for network idle (0, 2, or custom).
• Title: PDF document title metadata. See metadata guide.
• InputEncoding: Character encoding. UTF-8 is default. See UTF-8 guide.
• RequestContext: Request context for render.
• Timeout: Render timeout in seconds.

How do I implement headers and footers?

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs

using IronSoftware.Drawing;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                TextHeader = new IronPdf.TextHeaderFooter()
                {
                    CenterText = "Invoice",
                    DrawDividerLine = false,
                    Font = FontTypes.Arial,
                    FontSize = 12
                },
                TextFooter = new IronPdf.TextHeaderFooter()
                {
                    LeftText = "{date} - {time}",
                    RightText = "Page {page} of {total-pages}",
                    Font = IronSoftware.Drawing.FontTypes.Arial,
                    FontSize = 12,
                },
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);
        }
    }
}

Alternatively, generate HTML headers and footers using the HtmlHeaderFooter class, which supports CSS, images, and hyperlinks.

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                MarginTop = 50, // make sufficiant space for an HTML header
                HtmlHeader = new IronPdf.HtmlHeaderFooter()
                {
                    HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"
                }
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions);
        }
    }
}

As seen in our examples, merge dynamic text or HTML into headers/footers using placeholders:

• {page}: Current page number.
• {total-pages}: Total number of pages.
• {url}: Web URL from which the PDF was rendered.
• {date}: Today's date in system format.
• {time}: Time in 24-hour format.
• {html-title}: Title from ASPX head tag.
• {pdf-title}: Document filename.