Comment convertir les vues ASP.NET MVC en PDF : IronPDF vs iTextSharp

Installation d'iTextSharp

Pour ajouter iTextSharp à votre projet ASP.NET Core MVC, installez le package NuGet à l'aide de la console du gestionnaire de packages :

Install-Package iTextSharp

Install-Package iTextSharp

Mise en œuvre de base avec iTextSharp

Voici un exemple complet montrant comment convertir une vue MVC en PDF à l'aide de la classe XMLWorkerHelper d'iTextSharp dans votre projet ASP.NET MVC :

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()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Nonw.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
        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()
    {
        // Create a simple invoice HTML
        string invoiceHtml = @"
            <h1>Invoice #1001</h1>
            <p>Date: " + DateTime.Nonw.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
        return new FileContentResult(stream.ToArray(), "application/pdf")
        {
            FileDownloadName = "invoice.pdf"
        };
    }
}

Imports iTextSharp.text
Imports iTextSharp.tool.xml
Imports iTextSharp.text.pdf
Imports System.IO

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GeneratePDF() As ActionResult
        ' Create a simple invoice HTML
        Dim invoiceHtml As String = "
            <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 stream As New MemoryStream()
            Dim document As New Document(PageSize.A4)
            Dim writer As PdfWriter = PdfWriter.GetInstance(document, stream)
            document.Open()

            Using srHtml As New StringReader(invoiceHtml)
                XMLWorkerHelper.GetInstance().ParseXHtml(writer, document, srHtml)
            End Using

            document.Close()

            ' Return the PDF file
            Return New FileContentResult(stream.ToArray(), "application/pdf") With {
                .FileDownloadName = "invoice.pdf"
            }
        End Using
    End Function
End Class

Cet exemple crée un document PDF basique à partir de contenu HTML. La classe XMLWorkerHelper traite la chaîne HTML et ajoute des éléments au document PDF en utilisant le modèle objet. Le PdfWriter gère le processus de génération PDF proprement dit, tandis que le Document gère la structure de la page.

Sortie

Quelles sont les principales limitations d'iTextSharp ?

La classe XMLWorkerHelper prend en charge les balises HTML de base et le CSS en ligne. Les propriétés CSS3 modernes, les mises en page flexbox et les systèmes de grille ne sont pas rendus. Le contenu dépendant de JavaScript disparaît entièrement. Les styles complexes tels que les dégradés, les ombres et les transformations sont ignorés. Même les classes Bootstrap standard ne s'appliquent pas, ce qui donne aux vues soigneusement conçues un aspect simple et peu professionnel.

De nombreux développeurs ont reporté ces limitations sur Stack Overflow, entraînant une frustration lorsqu'ils essaient de convertir des vues MVC en PDF avec iTextSharp.

Le modèle de licence d'iTextSharp est peut-être encore plus préoccupant. La bibliothèque utilise la licence AGPL, qui exige que vous mettiez en open-source l'ensemble de votre application si vous utilisez la version gratuite. Les licences commerciales coûtent plusieurs milliers de dollars par an, ce qui les rend prohibitifs pour de nombreuses entreprises. Cette restriction de licence a poussé de nombreux développeurs à chercher des alternatives qui correspondent mieux aux besoins de développement commercial. Comme indiqué dans la documentation .NET de Microsoft , le choix de bibliothèques dotées de licences appropriées est essentiel pour les projets commerciaux.

Comment installer IronPDF?

Ajoutez IronPDF à votre projet via la console du gestionnaire de packages NuGet :

Install-Package IronPdf

Install-Package IronPdf

Mise en œuvre moderne avec IronPDF

La même facture créée ci-dessus utilise désormais du CSS moderne et un rendu HTML5 complet grâce à ChromePdfRenderer d'IronPDF :

using IronPdf;

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

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML 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.Nonw.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>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

using IronPdf;

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

    public ActionResult GenerateModernPDF()
    {
        // Create a styled invoice HTML 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.Nonw.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>";

        // Use Chromium engine for rendering
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(invoiceHtml);

        // Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf");

        // Return the PDF file with binary data
        return new FileContentResult(pdf.BinaryData, "application/pdf");
    }
}

Imports IronPdf

Public Class HomeController
    Inherits Controller

    Public Function Index() As ActionResult
        Return View()
    End Function

    Public Function GenerateModernPDF() As ActionResult
        ' Create a styled invoice HTML with modern CSS
        Dim invoiceHtml As String = "
            <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>"

        ' Use Chromium engine for rendering
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf(invoiceHtml)

        ' Set content disposition for download
        Response.Headers.Append("Content-Disposition", "attachment; filename=modern-invoice.pdf")

        ' Return the PDF file with binary data
        Return New FileContentResult(pdf.BinaryData, "application/pdf")
    End Function
End Class

Le ChromePdfRenderer convertit le HTML exactement comme Chrome l'afficherait. Les dégradés, les polices modernes et les styles sophistiqués s'affichent tous avec précision. Le moteur de rendu gère les propriétés CSS complexes qu'iTextSharp ne peut pas traiter, notamment flexbox, les mises en page en grille et les transformations CSS rendues sous forme de cadres statiques. La méthode RenderHtmlAsPdf simplifie la conversion de HTML en PDF dans MVC.

Sortie

Démarrez votre essai gratuit et découvrez la génération moderne de PDF grâce au moteur de rendu basé sur Chrome.

Comparaison des fonctionnalités

Considérations relatives aux licences

La différence de licence entre ces bibliothèques a un impact significatif sur le développement commercial. la licence AGPL d'iTextSharp crée des obligations légales que de nombreuses entreprises ne peuvent accepter. L'utilisation de la version gratuite nécessite l'ouverture de l'ensemble de votre application, y compris la logique commerciale propriétaire. Cette restriction rend iTextSharp inadapté à la plupart des projets commerciaux, à moins que vous n'achetiez une licence commerciale onéreuse.

IronPDF propose une licence commerciale simple à partir de $799 pour un seul développeur. La licence comprend un an de mises à jour et d'assistance, sans obligation de mettre votre application en open-source. Ce modèle de tarification transparent s'aligne sur les budgets typiques de développement de logiciels, rendant la génération de PDF professionnels accessible aux entreprises de toutes tailles lors de la conversion de vues MVC en PDF en C#.

Analyse de la qualité des sorties

La différence de qualité de rendu devient immédiatement évidente lorsque l'on compare les résultats. iTextSharp produit des PDF basiques qui ressemblent à des documents du début des années 2000. Les tableaux n'ont pas de style approprié, les polices sont par défaut des normes du système et les éléments de conception modernes disparaissent complètement. Les PDF qui en résultent ne sont pas professionnels et ne correspondent pas à l'image de marque de votre application.

IronPDF génère des PDF d'une précision pixel parfaite, parfaitement adaptés à votre design web. Les dégradés s'affichent avec précision, les polices personnalisées correctement et les mises en page complexes conservent leur structure. Le moteur Chromium garantit que vos PDF s'affichent de manière identique à la version web, préservant ainsi l'identité de marque et l'aspect Professional de tous les documents générés.

En-têtes et pieds de page

Ajoutez des en-têtes et des pieds de page professionnels avec un contenu dynamique :

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>"
        }
    }
};

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

Cette configuration permet d'ajouter une image de marque cohérente à chaque page. Les espaces réservés {page} et {total-pages} se remplissent automatiquement avec les valeurs correctes, assurant une pagination précise dans tout votre document. Pour plus d'options de configuration, consultez le guide des en-têtes et pieds de page .

Sécurité et Chiffrement

Protégez vos documents sensibles par des mots de passe et des autorisations grâce aux fonctionnalités de sécurité d'IronPDF :

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;

Dim 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

Ces paramètres de sécurité empêchent les accès non autorisés et contrôlent la façon dont les destinataires peuvent interagir avec vos PDF lorsque vous convertissez des vues MVC en PDF. Vous pouvez limiter l'impression, la copie et la modification tout en conservant le contrôle total du propriétaire. Pour en savoir plus, consultez la documentation de sécurité au format PDF .

Sortie

Traitement des champs de formulaire

IronPDF convertit les formulaires HTML en formulaires PDF interactifs sans nécessiter d'outils supplémentaires :

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);

Imports System

Dim formHtml As String = "
    <form>
        <label>Name:</label>
        <input type='checkbox'> Accept Terms
        <select name='country'>
            <option>USA</option>
            <option>Canada</option>
        </select>
    </form>"

Dim pdf = renderer.RenderHtmlAsPdf(formHtml)

Le PDF résultant conserve l'interactivité du formulaire, permettant aux utilisateurs de remplir les champs directement dans leur lecteur PDF. Cette fonctionnalité élimine le besoin d'outils de création de formulaires distincts, simplifiant ainsi votre flux de travail documentaire. Consultez la documentation relative aux formulaires pour découvrir d'autres options.

Sortie

Optimisation du rendu CSS

Pour obtenir de meilleurs résultats avec des feuilles de style CSS complexes lorsque vous convertissez des fichiers HTML au format PDF, utilisez des requêtes de support d'impression :

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

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

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

Ce paramètre applique des règles CSS spécifiques à l'impression, optimisant les mises en page pour la sortie PDF plutôt que pour l'affichage à l'écran. L'association de ces éléments avec des feuilles de style optimisées pour l'impression vous offre un contrôle précis sur les sauts de page, les marges et la typographie. Le guide des types de médias CSS explique des options de rendu supplémentaires.

Temps d'exécution JavaScript

Lors de la conversion de contenu dynamique, laissez le temps à l'exécution du JavaScript de se terminer avant de capturer le PDF. Cela garantit que tous les appels AJAX et les manipulations du DOM se terminent correctement :

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

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

Cette configuration garantit que les appels AJAX se terminent et que les manipulations DOM sont achevées avant que la génération du PDF ne commence, capturant ainsi l'état entièrement rendu de votre vue MVC. Pour les bibliothèques de graphiques et autres contenus utilisant beaucoup l'asynchrone, il peut être nécessaire d'augmenter la valeur du délai.

Sortie

Intégration de polices et formatage de documents

Pour garantir un affichage correct des polices personnalisées, intégrez-les directement dans votre code HTML à l'aide d'URI de données encodées en base64 :

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

L'intégration des polices directement dans le code HTML garantit un rendu cohérent dans tous les environnements, éliminant ainsi les problèmes de polices manquantes dans les documents PDF générés. Cette approche fonctionne tout aussi bien, que vous utilisiez un rendu basé sur une URL via RenderUrlAsPdf ou un rendu basé sur une chaîne de caractères via RenderHtmlAsPdf.

Pour plus d'options de configuration, notamment la taille de la page, l'orientation et le contrôle des marges, consultez la documentation des options de rendu IronPDF . Vous pouvez également consulter des exemples de projets sur GitHub qui illustrent les modèles d'intégration MVC courants.