Przejście zRotativana IronPDF pozwala wyeliminować krytyczne luki w zabezpieczeniach, jednocześnie modernizując proces tworzenia plików PDF. Niniejszy przewodnik zawiera kompletną, krok po kroku ścieżkę migracji, która eliminuje porzuconą zależność od wkhtmltopdf, umożliwia obsługę nowoczesnego CSS i JavaScript oraz zapewnia kompatybilność międzyplatformową wykraczającą poza ASP.NET MVC.
Rotativa od dawna cieszy się popularnością wśród programistów jako narzędzie do generowania plików PDF w języku C#. Wykorzystuje narzędzie wkhtmltopdf do konwersji treści HTML na format PDF.Rotativato biblioteka open source zaprojektowana specjalnie dla aplikacji ASP.NET MVC. Jednak mimo żeRotativaprzyciągnęła znaczną grupę odbiorców, jej poleganie na przestarzałym stosie technologicznym stwarza wyzwania, które mogą nie być od razu oczywiste dla każdego programisty.
W swojej podstawie,Rotativazapewnia prosty sposób integracji generowania PDF w projektach ASP.NET MVC, wykorzystując wkhtmltopdf do funkcjonalności backendowych.
Rotativa wykorzystuje bibliotekę wkhtmltopdf, która zawiera KRYTYCZNE, NIEZŁATANE LUKI W BEZPIECZEŃSTWIE.
| Atrybut | Wartość |
|---|---|
| ID CVE | CVE-2022-35583 |
| Waga | KLUCZOWE (9,8/10) |
| Wektor ataku | Sieć |
| Status | Brak naprawionej wersji (binaria wkhtmltopdf zarchiwizowane) |
| Dotyczy | Wszystkie wersjeRotativałączące wkhtmltopdf 0.12.6 |
Repozytorium GitHub wkhtmltopdf zostało zarchiwizowane (tylko do odczytu) 2 stycznia 2023. Strona statusu wnotki, że projekt zależy od Qt 4 (nie wspierany od 2015) i od gałęzi WebKit z 2012 roku, i wyraźnie ostrzega przed używaniem go z niepewnym HTML.CVE-2022-35583nie ma naprawionej wersji, więc każda aplikacja używającaRotativajest narażona, chyba że wejścia HTML są całkowicie zdezynfekowane na wstępie.
<!-- 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" />Wpływ:
Rotativa wykorzystuje bibliotekę wkhtmltopdf, która korzysta z:
| Funkcja | Rotativa | IronPDF |
|---|---|---|
| Zgodność projektu | Tylko ASP.NET MVC | Dowolny typ projektu .NET (MVC, Razor Pages, Blazor itp.) |
| Konserwacja | Porzucony | Aktywnie utrzymywane |
| Bezpieczeństwo | Podatność spowodowana zależnościami wkhtmltopdf (CVE-2022-35583) | Regularne aktualizacje i poprawki bezpieczeństwa |
| Renderowanie HTML | Przestarzały WebKit | Nowoczesny Chromium |
| CSS3 | Częściowe | Obsługiwane |
| Flexbox/Grid | Nieobsługiwane | Obsługiwane |
| JavaScript | Niewiarygodne | Pełna obsługa ES6+ |
| Razor Pages | Nieobsługiwane | Obsługiwane |
| Blazor | Nieobsługiwane | Obsługiwane |
| Manipulacja plikami PDF | Niedostępne | Pełna |
| Podpisy cyfrowe | Niedostępne | Pełna |
| Zgodność z PDF/A | Niedostępne | Pełna |
| Async/Await | Tylko synchroniczne | Pełna asynchroniczność |
| Otwarte Źródło | Tak, licencja MIT | Nie, licencja komercyjna |
Dla zespołów celujących w bieżące wersje .NET,IronPDF oferuje nowoczesną obsługę renderowania przez Chromium i wsparcie międzyplatformowe, któregoRotativanie może zapewnić.
Oryginalny pakiet Rotativa jest przeznaczony dla klasycznego ASP.NET MVC 5 (ostatnia wersja v1.7.3, 2017-09-29). Fork społecznościowy Rotativa.AspNetCore (webgio) osiągnął v1.4.0 w dniu 2024-11-06 i wspiera od .NET Core 3.1 do .NET 8 — ale oba pakiety nadal dostarczają binarium wkhtmltopdf 0.12.6 (ostatnia wersja upstream czerwiec 2020).
# Remove Rotativa
dotnet remove package Rotativa
dotnet remove package Rotativa.AspNetCore
# Install IronPDF
dotnet add package IronPdfUsuń te pliki z projektu:
wkhtmltopdf.exewkhtmltox.dllRotativa/Są to źródła CVE-2022-35583.IronPDF nie wymaga natywnych plików binarnych.
// 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| KlasaRotativa | Odpowiednik IronPDF |
|---|---|
ViewAsPdf | ChromePdfRenderer |
ActionAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
UrlAsPdf | ChromePdfRenderer.RenderUrlAsPdf() |
Orientation enum | PdfPaperOrientation enum |
Size enum | PdfPaperSize enum |
| Rotativa Placeholder | IronPDF Placeholder |
|---|---|
[page] | {page} |
[topage] | {total-pages} |
[date] | {date} |
[time] | {time} |
[title] | {html-title} |
[sitepage] | {url} |
Przed (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
};
}
}
}Po (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 ModuleTen przykład ilustruje podstawową różnicę architektoniczną.Rotativawymaga zwrócenia wyniku ViewAsPdf z akcji kontrolera MVC, co wiąże cię do frameworku ASP.NET MVC. Ten wzorzec działa wyłącznie w ramach potoku żądań MVC i wymaga widoku Razor do renderowania.
IronPDF działa wszędzie: w aplikacjach konsolowych, interfejsach API sieci Web, Blazor, Razor Pages lub dowolnym typie projektu .NET. Wywołujesz RenderHtmlAsPdf() z ciągiem HTML i zapisujesz rezultat. Nie jest wymagany kontroler MVC, brak zależności od widoku. Kompleksowe przykłady można znaleźć w dokumentacji dotyczącej konwersji HTML do PDF.
Przed (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
};
}
}
}Po (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 ModuleKlasa UrlAsPdfRotativawymaga zwrócenia ActionResult z kontrolera MVC. Metoda RenderUrlAsPdf()IronPDF może być wywołana z dowolnego kontekstu i zwraca obiekt PdfDocument bezpośrednio. Renderowanie adresów URL wykorzystuje nowoczesny silnik Chromium zamiast podatnego na ataki i przestarzałego silnika WebKit używanego przez wkhtmltopdf. Dowiedz się więcej z naszych samouczków.
Przed (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 NamespacePo (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 używa CustomSwitches do przekazywania argumentów wiersza poleceń do wkhtmltopdf, w tym konfiguracji nagłówka i stopki z takimi placeholderami jak [page] i [topage]. To podejście oparte na ciągach znaków jest podatne na błędy i trudne do zweryfikowania w czasie kompilacji.
IronPDF używa silnie typowanych obiektów TextHeaderFooter z właściwościami takimi jak CenterText i DrawDividerLine. Składnia placeholderów zmienia się z [page] na {page} i z [topage] na {total-pages}. Właściwości typowane zapewniają funkcję IntelliSense, sprawdzanie w czasie kompilacji oraz brak ryzyka wystąpienia literówek.
Rotativa została zaprojektowana dla ASP.NET MVC 5 i wcześniejszych wersji:
// ❌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 oddziela renderowanie widoków od generowania plików PDF, co w rzeczywistości zapewnia większą elastyczność — można renderować dowolny kod HTML, a nie tylko widoki MVC.
Rotativa blokuje wątek;IronPDF obsługuje pełną funkcję 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- Pełna asynchroniczność support
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
}' ❌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- Pełna asynchroniczność support
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 FunctionPo migracji do IronPDF zyskujesz możliwości, którychRotativanie jest w stanie zapewnić:
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 i Rotativa.AspNetCorewkhtmltopdf.exe, wkhtmltox.dll)IronPdfusing Rotativa; → using IronPdf;)ViewAsPdf na ChromePdfRenderer + RenderHtmlAsPdf()UrlAsPdf na RenderUrlAsPdf()CustomSwitches na właściwości RenderingOptions[page] → {page}, [topage] → {total-pages})PageMargins na indywidualne MarginRight
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
