Die Migration von Rotativazu IronPDF behebt kritische Sicherheitslücken und modernisiert gleichzeitig Ihren PDF-Erzeugungsworkflow. Dieses Handbuch bietet einen vollständigen, schrittweisen Migrationspfad, der die verlassene wkhtmltopdf-Abhängigkeit beseitigt, Unterstützung für modernes CSS und JavaScript ermöglicht und plattformübergreifende Kompatibilität über ASP.NET MVC hinaus bietet.
Rotativa ist seit langem eine beliebte Wahl unter Entwicklern für die Erstellung von PDFs in C#. Es nutzt das wkhtmltopdf-Tool, um HTML-Inhalte in PDF-Format zu konvertieren. Rotativaist eine Open-Source-Bibliothek, die speziell für ASP.NET MVC-Anwendungen entwickelt wurde. Obwohl Rotativaein großes Publikum angezogen hat, stellt die Tatsache, dass es sich auf eine veraltete Technologie stützt, eine Herausforderung dar, die vielleicht nicht jedem Entwickler sofort klar ist.
Im Kern bietet Rotativaeine einfache Möglichkeit, die PDF-Erstellung in ASP.NET MVC-Projekte zu integrieren, wobei es die Backend-Funktionen von wkhtmltopdf nutzt.
Rotativa umhüllt wkhtmltopdf, das KRITISCHE UNGESCHÜTZTE SICHERHEITSMÄNGEL aufweist.
| Attribut | Wert |
|---|---|
| CVE ID | CVE-2022-35583 |
| Schweregrad | KRITISCH (9.8/10) |
| Attack Vector | Netzwerk |
| Status | Keine feste Version (wkhtmltopdf-Binärdatei archiviert) |
| Betroffen | Alle Rotativa-Versionen bündeln wkhtmltopdf 0.12.6 |
Das wkhtmltopdf GitHub-Repository wurde am 2. Januar 2023 archiviert (schreibgeschützt). Die Statusseite des Maintainers vermerkt, dass das Projekt von Qt 4 abhängt (seit 2015 nicht mehr unterstützt) und einem WebKit-Zweig aus 2012, und warnt ausdrücklich davor, es mit nicht vertrauenswürdigen HTML-Dateien zu verwenden. CVE-2022-35583hat keine feste Version, sodass jede Anwendung, die Rotativaverwendet, ausgesetzt ist, es sei denn, HTML-Eingaben werden vollständig zuvor bereinigt.
<!-- Attacker submits this content via your MVC model -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin" />Auswirkung:
Rotativa umhüllt wkhtmltopdf, das verwendet:
| Feature | Rotativa | IronPDF |
|---|---|---|
| Projektkompatibilität | Nur ASP.NET MVC | Jeder .NET-Projekttyp (MVC, Razor Pages, Blazor, etc.) |
| Wartung | Aufgegeben | Aktiv gewartet |
| Sicherheit | Anfällig aufgrund von wkhtmltopdf-Abhängigkeiten (CVE-2022-35583) | Regelmäßige Updates und Sicherheitspatches |
| HTML-Rendering | Veraltetes WebKit | Modernes Chromium |
| CSS3 | Teilweise | Unterstützt |
| Flexbox/Grid | Nicht unterstützt | Unterstützt |
| JavaScript | Unzuverlässig | Vollständig ES6+ |
| Razor-Seiten | Nicht unterstützt | Unterstützt |
| Blazor | Nicht unterstützt | Unterstützt |
| PDF-Bearbeitung | Nicht verfügbar | Voll |
| Digitale Signaturen | Nicht verfügbar | Voll |
| PDF/A-Konformität | Nicht verfügbar | Voll |
| Async/Await | Nur synchron | Vollständig asynchron |
| Open Source | Ja, MIT-Lizenz | Nein, kommerzielle Lizenz |
Für Teams, die auf aktuelle .NET-Versionen abzielen, bietet IronPDF moderne Chromium-Rendering- und plattformübergreifende Unterstützung, die Rotativanicht bieten kann.
Das ursprüngliche Rotativa-Paket richtet sich an das klassische ASP.NET MVC 5 (letzte Veröffentlichung v1.7.3, 29.09.2017). Der Community Fork Rotativa.AspNetCore (webgio) erreichte die Version v1.4.0 am 06.11.2024 und unterstützt .NET Core 3.1 bis .NET 8 – jedoch liefern beide Pakete immer noch die wkhtmltopdf 0.12.6-Binärdatei (letzte Upstream-Veröffentlichung Juni 2020).
# Remove Rotativa
dotnet remove package Rotativa
dotnet remove package Rotativa.AspNetCore
# Install IronPDF
dotnet add package IronPdfLöschen Sie diese Dateien aus Ihrem Projekt:
wkhtmltopdf.exewkhtmltox.dllRotativa/-OrdnerDiese sind die Quelle von CVE-2022-35583.IronPDF benötigt keine nativen Binärdateien.
// Add in Program.cs or Startup.cs
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";' Add in Program.vb or Startup.vb
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"// Before: Rotativa
using Rotativa;
using Rotativa.Options;
using Rotativa.AspNetCore;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;' Before: Rotativa
Imports Rotativa
Imports Rotativa.Options
Imports Rotativa.AspNetCore
' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering| Rotativa-Klasse | IronPDF-Äquivalent |
|---|---|
ViewAsPdf | ChromePdfRenderer |
ActionAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
UrlAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
Orientation Enum | PdfPaperOrientation Enum |
Size Enum | PdfPaperSize Enum |
| RotativaPlatzhalter | IronPDF Platzhalter |
|---|---|
[page] | {page} |
[topage] | {total-pages} |
[date] | {date} |
[time] | {time} |
[title] | {html-title} |
[sitepage] | {url} |
Vor (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
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
};
}
}
}Nach (IronPDF):
// 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
Imports IronPdf
Imports System
Module IronPdfExample
Sub Main()
Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = "<h1>Hello World</h1><p>This is a PDF document.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF generated successfully!")
End Sub
End ModuleDieses Beispiel verdeutlicht den grundlegenden architektonischen Unterschied. Rotativaerfordert, dass ein ViewAsPdf-Ergebnis von einer MVC-Controller-Aktion zurückgegeben wird, was Sie an das ASP.NET MVC-Framework bindet. Das Muster funktioniert nur innerhalb der MVC-Anfrage-Pipeline und erfordert eine Razor-Ansicht zum Rendern.
IronPDF funktioniert überall: Konsolenanwendungen, Web-APIs, Blazor, Razor Pages oder jede Art von .NET-Projekt. Sie rufen RenderHtmlAsPdf() mit einem HTML-String auf und speichern das Ergebnis. Kein MVC-Controller erforderlich, keine View-Abhängigkeit. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.
Vor (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
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
};
}
}
}Nach (IronPDF):
// 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
Imports IronPdf
Imports System
Module IronPdfExample
Sub Main()
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://www.example.com")
pdf.SaveAs("webpage.pdf")
Console.WriteLine("URL converted to PDF successfully!")
End Sub
End ModuleDie UrlAsPdf-Klasse von Rotativaerfordert die Rückgabe eines ActionResult von einem MVC-Controller. Die RenderUrlAsPdf()-Methode von IronPDF kann aus jedem Kontext aufgerufen werden und gibt ein PdfDocument-Objekt direkt zurück. Das URL-Rendering verwendet modernes Chromium anstelle der anfälligen und veralteten WebKit-Engine von wkhtmltopdf. Erfahren Sie mehr in unseren Tutorials.
Vor (Rotativa):
// NuGet: Install-Package Rotativa.AspNetCore
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,
// Margins(top, right, bottom, left)
PageMargins = new Margins(20, 10, 20, 10),
CustomSwitches = "--header-center \"Page Header\" --footer-center \"Page [page] of [topage]\""
};
}
}
}Imports Microsoft.AspNetCore.Mvc
Imports Rotativa.AspNetCore
Imports Rotativa.AspNetCore.Options
Imports System.Threading.Tasks
Namespace RotativaExample
Public Class HeaderFooterController
Inherits Controller
Public Async Function GeneratePdfWithHeaderFooter() As Task(Of IActionResult)
Return New ViewAsPdf("Report") With {
.PageSize = Size.A4,
' Margins(top, right, bottom, left)
.PageMargins = New Margins(20, 10, 20, 10),
.CustomSwitches = "--header-center ""Page Header"" --footer-center ""Page [page] of [topage]"""
}
End Function
End Class
End NamespaceNach (IronPDF):
// 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
Imports IronPdf
Imports IronPdf.Rendering
Imports System
Module IronPdfExample
Sub Main(args As String())
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
.CenterText = "Page Header",
.DrawDividerLine = True
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter() With {
.CenterText = "Page {page} of {total-pages}",
.DrawDividerLine = True
}
Dim htmlContent As String = "<h1>Report Title</h1><p>Report content goes here.</p>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("report.pdf")
Console.WriteLine("PDF with headers and footers created successfully!")
End Sub
End ModuleRotativa verwendet CustomSwitches, um Befehlszeilenargumente an wkhtmltopdf zu übergeben, einschließlich der Kopf- und Fußzeileneinstellungen mit Platzhaltern wie [page] und [topage]. Dieser auf Zeichenketten basierende Ansatz ist fehleranfällig und bei der Kompilierung schwer zu validieren.
IronPDF verwendet stark typisierte TextHeaderFooter-Objekte mit Eigenschaften wie CenterText und DrawDividerLine. Die Platzhaltersyntax ändert sich von [page] zu {page} und von [topage] zu {total-pages}. Typisierte Eigenschaften bieten IntelliSense, Kompilierbarkeitsprüfung und kein Risiko von Tippfehlern.
Rotativa wurde für ASP.NET MVC 5 und früher entwickelt:
// ❌ Rotativa- Only works with classic MVC pattern
public class InvoiceController : Controller
{
public ActionResult InvoicePdf(int id)
{
var model = GetInvoice(id);
return new ViewAsPdf("Invoice", model); // Tied to MVC Views
}
}
// Problems:
// - No Razor Pages support
// - No Blazor support
// - No minimal APIs support
// - No ASP.NET Core native integrationImports System.Web.Mvc
Public Class InvoiceController
Inherits Controller
Public Function InvoicePdf(id As Integer) As ActionResult
Dim model = GetInvoice(id)
Return New ViewAsPdf("Invoice", model) ' Tied to MVC Views
End Function
End Class
' Problems:
' - No Razor Pages support
' - No Blazor support
' - No minimal APIs support
' - No ASP.NET Core native integrationIronPDF trennt das Rendering von Ansichten von der PDF-Generierung, was tatsächlich flexibler ist - Sie können jede HTML-Datei rendern, nicht nur MVC-Ansichten.
Rotativa blockiert das Thema;IronPDF unterstützt vollständig async/await:
// ❌ Rotativa- Blocks the thread
public ActionResult GeneratePdf()
{
return new ViewAsPdf("Report");
// This blocks the request thread until PDF is complete
// Poor scalability under load
}
// ✅IronPDF- Vollständig asynchronsupport
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
}Imports System.Threading.Tasks
Imports IronPdf
' ❌ Rotativa- Blocks the thread
Public Function GeneratePdf() As ActionResult
Return New ViewAsPdf("Report")
' This blocks the request thread until PDF is complete
' Poor scalability under load
End Function
' ✅IronPDF- Vollständig asynchronsupport
Public Async Function GeneratePdfAsync() As Task(Of IActionResult)
Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync(html)
Return File(pdf.BinaryData, "application/pdf")
' Non-blocking, better scalability
End FunctionNach der Umstellung auf IronPDF erhalten Sie Funktionen, die Rotativanicht bieten kann:
var merged = PdfDocument.Merge(pdf1, pdf2, pdf3);
merged.SaveAs("complete.pdf");Dim merged = PdfDocument.Merge(pdf1, pdf2, pdf3)
merged.SaveAs("complete.pdf")var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);Dim signature = New PdfSignature("certificate.pfx", "password")
pdf.Sign(signature)pdf.SecuritySettings.UserPassword = "secret";pdf.SecuritySettings.UserPassword = "secret"pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");IRON VB CONVERTER ERROR developers@ironsoftware.compdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b)// This now works (broke in Rotativa)
var html = @"
<div style='display: flex; justify-content: space-between;'>
<div>Left</div>
<div>Right</div>
</div>
<div style='display: grid; grid-template-columns: 1fr 1fr 1fr;'>
<div>Col 1</div><div>Col 2</div><div>Col 3</div>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html); // Works!' This now works (broke in Rotativa)
Dim html As String = "
<div style='display: flex; justify-content: space-between;'>
<div>Left</div>
<div>Right</div>
</div>
<div style='display: grid; grid-template-columns: 1fr 1fr 1fr;'>
<div>Col 1</div><div>Col 2</div><div>Col 3</div>
</div>"
Dim pdf = renderer.RenderHtmlAsPdf(html) ' Works![page] → {page})Rotativa und Rotativa.AspNetCore NuGet-Paketewkhtmltopdf.exe, wkhtmltox.dll)IronPdf NuGet-Paketusing Rotativa; → using IronPdf;)ViewAsPdf durch ChromePdfRenderer + RenderHtmlAsPdf()UrlAsPdf durch RenderUrlAsPdf()CustomSwitches in RenderingOptions-Eigenschaften[page] → {page}, [topage] → {total-pages})PageMargins durch einzelne MarginRight
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.
IronPDF ist ein Teil der IRONSUITE
10 .NET-API-Produkte für Ihre Bürodokumente
Wenn Ihr PDF wie HTML aussehen soll, schnell.
