IronPDF vs iTextSharp MVC View to PDF File in C#

Installing iTextSharp

To add iTextSharp to your ASP.NET Core MVC project, install the NuGet package:

Install-Package iTextSharp

Basic Implementation with iTextSharp

Here's a complete example showing how to convert an MVC view to PDF using iTextSharp's XMLWorkerHelper class in your ASP.NET MVC project:

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // First step: Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Now.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";
        // Create PDF document using iTextSharp
        using (var stream = new MemoryStream())
        {
            var document = new Document(PageSize.A4);
            PdfWriter writer = PdfWriter.GetInstance(document, stream);
            document.Open();
            using (var srHtml = new StringReader(invoiceHtml))
            {
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
            }
            document.Close();
            // Return the PDF file with binary data
            return new FileContentResult(stream.ToArray(), "application/pdf")
            {
                FileDownloadName = "invoice.pdf"
            };
        }
    }
}

using iTextSharp.text;
using iTextSharp.tool.xml;
using iTextSharp.text.pdf;
using System.IO;

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return View();
    }

    public ActionResult GeneratePDF()
    {
        // First step: Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Now.ToString("MM/dd/yyyy") + @"</p>
            <table border='1'>
                <tr><th>Item</th><th>Price</th></tr>
                <tr><td>Product A</td><td>$99.99</td></tr>
                <tr><td>Product B</td><td>$149.99</td></tr>
            </table>
            <p><strong>Total: $249.98</strong></p>";
        // Create PDF document using iTextSharp
        using (var stream = new MemoryStream())
        {
            var document = new Document(PageSize.A4);
            PdfWriter writer = PdfWriter.GetInstance(document, stream);
            document.Open();
            using (var srHtml = new StringReader(invoiceHtml))
            {
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml);
            }
            document.Close();
            // Return the PDF file with binary data
            return new FileContentResult(stream.ToArray(), "application/pdf")
            {
                FileDownloadName = "invoice.pdf"
            };
        }
    }
}

This complete code creates a basic PDF document from HTML content in your Visual Studio project. The XMLWorkerHelper class processes the HTML string and adds elements to the PDF document using the object model. The PdfWriter handles the actual PDF generation process, while the Document manages the page structure. Note that this example uses the newer approach recommended for better results.

Output

Understanding iTextSharp's Limitations

The XMLWorkerHelper class supports basic HTML tags and inline CSS. Modern CSS3 properties, flexbox layouts, and grid systems don't render. JavaScript-dependent content disappears entirely. Complex styling like gradients, shadows, and transforms are ignored. Even standard Bootstrap classes fail to apply, leaving your carefully designed views looking plain and unprofessional. Many developers have reported these limitations on Stack Overflow, leading to frustration when trying to convert MVC views to PDF with iTextSharp.

Perhaps more concerning is iTextSharp's licensing model. The library uses the AGPL license, which requires you to open-source your entire application if you use the free version. Commercial licenses start at several thousand dollars per year, making it expensive for many businesses. This licensing restriction has pushed many developers to seek alternatives that better align with commercial development needs. As discussed in Microsoft's .NET documentation, choosing libraries with appropriate licenses is crucial for commercial projects.

Installing IronPDF

Add IronPDF to your project with a simple NuGet command:

Install-Package IronPdf

Modern Implementation with IronPDF

Let's create the same invoice with enhanced styling using IronPDF in your ASP.NET MVC web application:

using IronPdf;
public class HomeController : Controller
{
    // Action method to display the index view
    public ActionResult Index()
    {
        return View();
    }
    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML file content with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";
        // Create PDF with Chrome rendering engine
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);
        // Set content disposition for download in browser
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");
        // Return the PDF file with binary data to the user
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;
public class HomeController : Controller
{
    // Action method to display the index view
    public ActionResult Index()
    {
        return View();
    }
    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML file content with modern CSS
        string invoiceHtml = @"
            <style>
                body { font-family: 'Segoe UI', Arial; padding: 40px; }
                .invoice-header {
                    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
                    color: white;
                    padding: 30px;
                    border-radius: 10px;
                }
                table {
                    width: 100%;
                    border-collapse: collapse;
                    margin: 20px 0;
                }
                th {
                    background-color: #f3f4f6;
                    padding: 12px;
                    text-align: left;
                }
                td {
                    padding: 12px;
                    border-bottom: 1px solid #e5e7eb;
                }
                .total {
                    font-size: 24px;
                    color: #10b981;
                    text-align: right;
                    margin-top: 20px;
                }
            </style>
            <div class='invoice-header'>
                <h1>Invoice #1001</h1>
                <p>Date: " + DateTime.Now.ToString("MMMM dd, yyyy") + @"</p>
            </div>
            <table>
                <tr><th>Item</th><th>Quantity</th><th>Price</th></tr>
                <tr><td>Premium Package</td><td>1</td><td>$99.99</td></tr>
                <tr><td>Professional Services</td><td>2</td><td>$149.99</td></tr>
            </table>
            <div class='total'>Total: $249.98</div>
            <p>Page numbers and additional content can be added to each page.</p>";
        // Create PDF with Chrome rendering engine
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);
        // Set content disposition for download in browser
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");
        // Return the PDF file with binary data to the user
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

This implementation leverages IronPDF's ChromePdfRenderer to convert the HTML exactly as it would appear in Chrome. The gradient backgrounds, modern fonts, and sophisticated styling all render perfectly. The renderer handles complex CSS properties that iTextSharp cannot process, including flexbox, grid layouts, transforms, and animations (rendered as static frames). The RenderHtmlAsPdf method makes converting HTML to PDF in MVC remarkably straightforward.

Output

Start your free trial and experience modern PDF generation with IronPDF's Chrome-powered rendering engine.

Feature Comparison

Licensing Considerations

The licensing difference between these libraries significantly impacts commercial development. iTextSharp's AGPL license creates legal obligations that many businesses cannot accept. Using the free version requires open-sourcing your entire application, including proprietary business logic. This restriction makes iTextSharp unsuitable for most commercial projects unless you purchase an expensive commercial license.

IronPDF offers straightforward commercial licensing starting at $799 for a single developer. The license includes one year of updates and support, with no obligation to open-source your application. This transparent pricing model aligns with typical software development budgets, making professional PDF generation accessible to businesses of all sizes when converting MVC views to PDF in C#.

Output Quality Analysis

The rendering quality difference becomes immediately apparent when comparing outputs. iTextSharp produces basic PDFs that resemble documents from the early 2000s. Tables lack proper styling, fonts default to system standards, and modern design elements disappear entirely. The resulting PDFs look unprofessional and fail to match your application's branding.

IronPDF generates pixel-perfect PDFs that exactly match your web design. Gradients render smoothly, custom fonts display correctly, and complex layouts maintain their structure. The Chromium engine ensures that your PDFs look identical to the web view, preserving your brand identity and professional appearance across all generated documents.

Headers and Footers

Add professional headers and footers with dynamic content:

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        HtmlHeader = new HtmlHeaderFooter
        {
            MaxHeight = 25,
            HtmlFragment = "<div style='text-align: center'>Company Name</div>"
        },
        HtmlFooter = new HtmlHeaderFooter
        {
            MaxHeight = 20,
            HtmlFragment = "<center>Page {page} of {total-pages}</center>"
        }
    }
};

This configuration adds consistent branding to every page. The placeholders {page} and {total-pages} automatically populate with the correct values, ensuring accurate pagination throughout your document.

Security and Encryption

Protect sensitive documents with passwords and permissions using IronPDF's comprehensive security features:

var pdf = renderer.RenderHtmlAsPdf(html);
// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

var pdf = renderer.RenderHtmlAsPdf(html);
// Add password protection
pdf.SecuritySettings.UserPassword = "user123";
pdf.SecuritySettings.OwnerPassword = "owner456";
// Set permissions
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

These security settings prevent unauthorized access and control how recipients can interact with your PDFs when you convert MVC views to PDF. You can restrict printing, copying, and editing while maintaining full owner control for administrative purposes.

Output

Form Field Handling

IronPDF seamlessly converts HTML forms into interactive PDF forms:

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);

string formHtml = @"
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>";
var pdf = renderer.RenderHtmlAsPdf(formHtml);

The resulting PDF maintains form interactivity, allowing users to fill fields directly in their PDF reader. This feature eliminates the need for separate form creation tools, streamlining your document workflow.

Output

CSS Rendering Optimization

For best results with complex CSS when you convert HTML files to PDF format, use print media queries:

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

This setting applies print-specific CSS rules, optimizing layouts for PDF output rather than screen display in the browser. The method ensures your document renders correctly.

JavaScript Execution Timing

When converting dynamic content and working with data from your database, allow time for JavaScript execution in your MVC project. This process ensures complete rendering:

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds

This configuration ensures that AJAX calls complete and DOM manipulations finish before PDF generation begins, capturing the fully rendered state of your MVC view to PDF. Note that this is the first step in handling dynamic content when you generate the PDF file.

Output

Font Embedding and Document Formatting

Ensure custom fonts render correctly by embedding them in your HTML. This example shows how to create a new paragraph with custom fonts in your source code:

@font-face {
    font-family: 'CustomFont';
    src: url(data:font/woff2;base64,[base64-encoded-font]) format('woff2');
}

Embedding fonts directly in the HTML guarantees consistent rendering across all environments, eliminating missing font issues in generated PDF documents. Using iTextSharp might require additional configuration for the same result. Simply write the proper CSS and render to produce professional PDFs with perfect formatting. Remember to download and test the final version on different systems to ensure compatibility.