Comprendre Rotativa

Rotativa est une bibliothèque open-source spécialement conçue pour les applications ASP.NET MVC. Elle intègre l'outil de ligne de commande wkhtmltopdf pour convertir le contenu HTML au format PDF. La bibliothèque fournit des types de résultats d'action spécifiques à MVC tels que ViewAsPdfet UrlAsPdfqui s'intègrent directement au modèle de contrôleur MVC.

Rotativa utilise le moteur de rendu Qt WebKit 4.8 de wkhtmltopdf datant de 2012. Cela signifie que la bibliothèque ne peut pas rendre les fonctionnalités CSS modernes telles que Flexbox ou CSS Grid, et que l'exécution JavaScript n'est pas fiable car elle ne prend pas en charge ES6+.

Considération critique : Rotativan'a pas reçu de mises à jour ou de maintenance depuis des années. Le wkhtmltopdf sous-jacent a été officiellement abandonné en décembre 2022, et les responsables ont explicitement déclaré qu'ils ne corrigeraient pas les vulnérabilités de sécurité. Cela inclut CVE-2022-35583, une vulnérabilité critique de type Server-Side Request Forgery (SSRF) avec un niveau de gravité de 9,8/10.

Comprendre IronPDF

IronPDF fournit une solution moderne de génération de PDF basée sur Chromium pour les applications .NET. La bibliothèque fonctionne avec n'importe quel type de projet .NET, y compris ASP.NET MVC, Razor Pages, Blazor, les API minimales, les applications de console et les projets de bureau.

L'architecture d'IronPDF sépare le rendu HTML de la génération de PDF, offrant ainsi plus de flexibilité dans la manière dont les développeurs structurent leurs applications. La classe ChromePdfRenderergère toutes les opérations de conversion avec une prise en charge complète des CSS3 modernes, du JavaScript ES6+ et des modèles async/await.

Comparaison de sécurité

Le niveau de sécurité de ces bibliothèques diffère considérablement :

La vulnérabilité CVE-2022-35583 permet aux attaquants d'accéder aux ressources du réseau interne, aux points d'extrémité des métadonnées du nuage et à la configuration sensible par le biais d'un contenu HTML élaboré. Étant donné que wkhtmltopdf ne sera jamais corrigé, chaque application utilisant Rotativareste exposée en permanence à cette vulnérabilité critique.

Compatibilité des projets

La limite la plus importante de Rotativaest sa focalisation exclusive sur ASP.NET MVC :

Rotativa a été conçu pour ASP.NET MVC 5 et les versions antérieures, en s'appuyant sur le modèle contrôleur-action-résultat. Cette architecture la rend inadaptée aux applications .NET Core modernes utilisant les pages Razor, Blazor ou des API minimales.

Conversion HTML en PDF

Les modèles de code pour la conversion HTML-PDF révèlent des différences architecturales fondamentales.

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class PdfController : Controller
    {
        public async Task<IActionResult> GeneratePdf()
        {
            var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";

            // Rotativarequires returning a ViewAsPdf result from MVC controller
            return new ViewAsPdf()
            {
                ViewName = "PdfView",
                PageSize = Rotativa.AspNetCore.Options.Size.A4
            };
        }
    }
}

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class PdfController : Controller
    {
        public async Task<IActionResult> GeneratePdf()
        {
            var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";

            // Rotativarequires returning a ViewAsPdf result from MVC controller
            return new ViewAsPdf()
            {
                ViewName = "PdfView",
                PageSize = Rotativa.AspNetCore.Options.Size.A4
            };
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();
            var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";

            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            pdf.SaveAs("output.pdf");

            Console.WriteLine("PDF generated successfully!");
        }
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();
            var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";

            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            pdf.SaveAs("output.pdf");

            Console.WriteLine("PDF generated successfully!");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Conversion d'URL en PDF

La conversion de pages web en PDF montre comment chaque bibliothèque gère la navigation et le rendu.

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class UrlPdfController : Controller
    {
        public async Task<IActionResult> ConvertUrlToPdf()
        {
            // Rotativaworks within MVC framework and returns ActionResult
            return new UrlAsPdf("https://www.example.com")
            {
                FileName = "webpage.pdf",
                PageSize = Rotativa.AspNetCore.Options.Size.A4,
                PageOrientation = Rotativa.AspNetCore.Options.Orientation.Portrait
            };
        }
    }
}

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class UrlPdfController : Controller
    {
        public async Task<IActionResult> ConvertUrlToPdf()
        {
            // Rotativaworks within MVC framework and returns ActionResult
            return new UrlAsPdf("https://www.example.com")
            {
                FileName = "webpage.pdf",
                PageSize = Rotativa.AspNetCore.Options.Size.A4,
                PageOrientation = Rotativa.AspNetCore.Options.Orientation.Portrait
            };
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();

            var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
            pdf.SaveAs("webpage.pdf");

            Console.WriteLine("URL converted to PDF successfully!");
        }
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();

            var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
            pdf.SaveAs("webpage.pdf");

            Console.WriteLine("URL converted to PDF successfully!");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mise en œuvre des en-têtes et pieds de page

Les en-têtes et les pieds de page du document font apparaître des différences significatives dans la conception des API.

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using Rotativa.AspNetCore.Options;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class HeaderFooterController : Controller
    {
        public async Task<IActionResult> GeneratePdfWithHeaderFooter()
        {
            return new ViewAsPdf("Report")
            {
                PageSize = Size.A4,
                PageMargins = new Margins(20, 10, 20, 10),
                CustomSwitches = "--header-center \"Page Header\" --footer-center \"Page [page] of [toPage]\""
            };
        }
    }
}

// NuGet: Install-Package Rotativa.Core
using Microsoft.AspNetCore.Mvc;
using Rotativa.AspNetCore;
using Rotativa.AspNetCore.Options;
using System.Threading.Tasks;

namespace RotativaExample
{
    public class HeaderFooterController : Controller
    {
        public async Task<IActionResult> GeneratePdfWithHeaderFooter()
        {
            return new ViewAsPdf("Report")
            {
                PageSize = Size.A4,
                PageMargins = new Margins(20, 10, 20, 10),
                CustomSwitches = "--header-center \"Page Header\" --footer-center \"Page [page] of [toPage]\""
            };
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();

            renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
            {
                CenterText = "Page Header",
                DrawDividerLine = true
            };

            renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
            {
                CenterText = "Page {page} of {total-pages}",
                DrawDividerLine = true
            };

            var htmlContent = "<h1>Report Title</h1><p>Report content goes here.</p>";
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            pdf.SaveAs("report.pdf");

            Console.WriteLine("PDF with headers and footers created successfully!");
        }
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;

namespace IronPdfExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var renderer = new ChromePdfRenderer();

            renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
            {
                CenterText = "Page Header",
                DrawDividerLine = true
            };

            renderer.RenderingOptions.TextFooter = new TextHeaderFooter()
            {
                CenterText = "Page {page} of {total-pages}",
                DrawDividerLine = true
            };

            var htmlContent = "<h1>Report Title</h1><p>Report content goes here.</p>";
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            pdf.SaveAs("report.pdf");

            Console.WriteLine("PDF with headers and footers created successfully!");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Référence à la syntaxe des espaces réservés

Matrice de comparaison des fonctionnalités

Référence de mappage d'API

Les équipes qui évaluent la migration de RotativaversIronPDFpeuvent se référer à cette cartographie des opérations équivalentes :

Le problème du threading

Rotativa hérite des limitations de threading de wkhtmltopdf :

// Rotativa- Blocks the thread
public ActionResult GeneratePdf()
{
    return new ViewAsPdf("Report");
    // This blocks the request thread until PDF is complete
    // Poor scalability under load
}

// Rotativa- Blocks the thread
public ActionResult GeneratePdf()
{
    return new ViewAsPdf("Report");
    // This blocks the request thread until PDF is complete
    // Poor scalability under load
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronPDF offre une prise en charge asynchrone complète :

//IronPDF- Full asyncsupport
public async Task<IActionResult> GeneratePdf()
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return File(pdf.BinaryData, "application/pdf");
    // Non-blocking, better scalability
}

//IronPDF- Full asyncsupport
public async Task<IActionResult> GeneratePdf()
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return File(pdf.BinaryData, "application/pdf");
    // Non-blocking, better scalability
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Le modèle synchrone uniquement de Rotativabloque les threads de demande, ce qui réduit l'évolutivité de l'application en cas de charge. La prise en charge asynchrone d'IronPDF permet une meilleure utilisation des ressources dans les scénarios à haut débit.

Considérations de déploiement

Rotativa doit gérer les binaires wkhtmltopdf dans les différents environnements de déploiement :

• Différents binaires pour les plateformes x86/x64/Linux/Mac
• Configuration manuelle de l'environnement PATH
• Vulnérabilités de sécurité dans toutes les versions binaires
• Les images Docker doivent inclure l'installation de wkhtmltopdf

IronPDF simplifie le déploiement grâce à l'empaquetage NuGet sans gestion externe des binaires.

Quand les équipes envisagent la migration vers Rotativa

Plusieurs facteurs incitent les équipes de développement à évaluer des alternatives à Rotativa:

Les exigences de sécurité deviennent critiques lorsque les scanners de vulnérabilité signalent la CVE-2022-35583. Comme wkhtmltopdf ne sera jamais corrigé, les organisations soumises à des audits de sécurité ou à des exigences de conformité doivent abandonner Rotativa.

<L'adoption moderne de .NET crée des incompatibilités lorsque les équipes passent à Razor Pages, Blazor ou à des API minimales. L'architecture MVC de Rotativane peut pas prendre en charge ces modèles modernes.

<Les limitations de rendu CSS affectent la qualité des documents lorsque les conceptions utilisent Flexbox ou CSS Grid. Le moteur WebKit de Rotativa, datant de 2012 et obsolète, ne peut pas rendre ces mises en page correctement.

La fiabilité de JavaScript a un impact sur le rendu du contenu dynamique. Le JavaScript complexe qui fonctionne dans les navigateurs échoue souvent ou s'affiche de manière incorrecte avec la prise en charge limitée du JavaScript par wkhtmltopdf.

L'évolutivité asynchrone est importante pour les applications à haut débit. Le modèle synchrone uniquement de Rotativabloque les threads, tandis qu'IronPDF prend en charge l'asynchronisme/attente complet pour une meilleure utilisation des ressources.

Forts et compromis

Conclusion

Rotativa a fourni une solution simple pour la génération de PDF dans les applications ASP.NET MVC lorsqu'elle était activement maintenue. Cependant, l'abandon de la bibliothèque, combiné à des vulnérabilités de sécurité critiques non corrigées dans sa fondation wkhtmltopdf, crée un risque important pour les applications de production.

Pour les équipes qui utilisent actuellement Rotativa, la combinaison des vulnérabilités en matière de sécurité, l'architecture MVC uniquement et les capacités de rendu obsolètes constituent des raisons impérieuses d'évaluer des alternatives. Pour les nouveaux projets visant .NET 10 et C# 14 en 2026, l'architecture de Rotativane peut pas prendre en charge les modèles modernes tels que Razor Pages, Blazor ou les API minimales.

IronPDF répond à ces limites grâce à un moteur de rendu moderne Chromium, une compatibilité .NET multiplateforme, une maintenance active et des fonctionnalités complètes de manipulation de PDF que Rotativan'a jamais offertes. Le chemin de migration de RotativaversIronPDFimplique principalement le remplacement des résultats d'action MVC par des appels directs ChromePdfRendereret la mise à jour de la syntaxe des placeholder dans les en-têtes et les pieds de page.

Pour des conseils de mise en œuvre, explorez le tutorielIronPDFASP.NET Core et documentation couvrant les modèles de génération de PDF pour les applications .NET modernes.