How to Convert HTML to PDF in ASP.NET using C# with IronPDF

What Does the Generated PDF Look Like?

This code creates a simple controller that generates PDF documents directly from HTML strings. The ChromePdfRenderer class handles all the complex rendering, ensuring your HTML structure, CSS styles, and even JavaScript render correctly in the final PDF output.

How Do I Convert Dynamic HTML Strings?

When working with dynamic content like database-driven reports, use RenderHtmlAsPdf to convert HTML strings directly. This method is perfect for generating PDF reports from templates:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // Your method to generate HTML
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

What Results Can I Expect from HTML String Conversion?

This approach is perfect for generating PDF documents from HTML templates populated with real-time data, form submissions, or any dynamically generated HTML content. The rendering engine preserves all CSS styling including custom fonts, colors, and table formatting.

When Should I Convert HTML Files from Disk?

For static HTML templates stored as files, use RenderHtmlFileAsPdf to convert HTML files directly. This is ideal when working with template-based PDF generation:

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

This method efficiently handles existing HTML files, automatically resolving relative URLs for CSS styles, images, and external resources. It's particularly useful when working with complex layouts or custom fonts.

How Do I Convert Web URLs to PDF?

To capture entire web pages or render existing URLs as PDFs, use the URL conversion method. This feature supports JavaScript rendering and render delays:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("___PROTECTED_URL_79___");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000); // Wait an extra second for JavaScript to load
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var PDF = renderer.RenderUrlAsPdf("___PROTECTED_URL_79___");
pdf.SaveAs("webpage.pdf");

What Does URL-Based PDF Conversion Produce?

This effective feature supports complex JavaScript rendering, making it ideal for converting single-page applications or dynamically loaded web content from a specified URL. The Chrome rendering engine ensures accurate reproduction of modern web features.

What Does the Form Interface Look Like?

How Does Form Data Appear in the Generated PDF?

For more complex scenarios, you can integrate PDF forms or edit existing PDF templates to create dynamic documents. The library also supports digital signatures for legal documents and contracts.

How Do I Add Professional Headers, Footers, and Watermarks?

Professional PDF documents often require headers and footers along with watermarks. IronPDF makes these additions straightforward with effective editing features that simplify PDF manipulation:

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
// Configure headers and footers
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
// Generate PDF
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Add watermark
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

What Do Watermarks and Headers Look Like in PDFs?

These features transform basic HTML to PDF conversion into professional document generation, perfect for contracts, reports, and official documents. You can also add page numbers, backgrounds and foregrounds, or even custom stamps.

How Can I Improve CSS and Print Media for PDFs?

To ensure your PDF output matches expectations, use CSS print media queries and responsive design principles. IronPDF fully supports page breaks and custom paper sizes:

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
// Configure margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
// Configure CSS media type
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Set viewport for responsive designs
renderer.RenderingOptions.ViewPortWidth = 1024;
// Configure margins
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string HTML = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var PDF = renderer.RenderHtmlAsPdf(html);

What Formatting Improvements Does Print CSS Provide?

Using print CSS ensures your PDF documents maintain professional formatting while hiding unnecessary web elements like navigation menus or interactive buttons. You can control features like page break positioning to ensure optimal rendering. You can also set custom margins and control page orientation.

How Do I Handle Authentication and Security?

For secure applications, IronPDF supports various authentication methods including cookies, HTTP headers, and network credentials. Here's an example of rendering a protected page:

var renderer = new ChromePdfRenderer();
// Add authentication cookie
renderer.RequestContext.Cookies.Add(new Cookie
{
    Name = "SessionId",
    Value = "your-session-token",
    Domain = "example.com"
});
// Or use basic authentication
renderer.ChromePdfRenderOptions.HttpLoginCredentials = new HttpLoginCredentials
{
    Username = "user",
    Password = "password"
};
var PDF = renderer.RenderUrlAsPdf("___PROTECTED_URL_80___");

var renderer = new ChromePdfRenderer();
// Add authentication cookie
renderer.RequestContext.Cookies.Add(new Cookie
{
    Name = "SessionId",
    Value = "your-session-token",
    Domain = "example.com"
});
// Or use basic authentication
renderer.ChromePdfRenderOptions.HttpLoginCredentials = new HttpLoginCredentials
{
    Username = "user",
    Password = "password"
};
var PDF = renderer.RenderUrlAsPdf("___PROTECTED_URL_80___");

You can also encrypt PDFs with passwords and set permissions, or add digital signatures for document authenticity.