Rotativaについて

Rotativaは、C#でPDFを生成するための開発者の間で長い間人気のある選択肢です。 wkhtmltopdfツールを活用し、HTMLコンテンツをPDF形式に変換します。 Rotativaは、ASP.NET MVCアプリケーションのために特別に設計されたオープンソースのライブラリです。 しかし、Rotativaは多くの読者を惹きつける一方で、時代遅れの技術スタックに依存しているため、すべての開発者がすぐに理解できるとは限らないという課題があります。

Rotativaは、ASP.NET MVCプロジェクトにPDF生成を統合する簡単な方法を提供し、そのバックエンド機能にはwkhtmltopdfを利用しています。

重要なセキュリティ勧告

Rotativaはwkhtmltopdfをラップしていますが、これはCRITICAL UNPATCHED SECURITY VULNERABILITIES.を持っています。

wkhtmltopdfは、2022年12月に正式に放棄されました。メンテナンス担当者は、セキュリティの脆弱性を修正しないと明言しています。 Rotativaを使用するすべてのアプリケーションは、永久に公開されます。

攻撃の仕組み

<!-- 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" />

<!-- 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" />

インパクト:

• AWS/Azure/GCPクラウドメタデータエンドポイントへのアクセス
• 内部APIデータと認証情報を盗む
• 内部ネットワークのポートスキャン
• 機密設定の流出

テクノロジーの危機

Rotativaは、wkhtmltopdfをラップしています：

• Qt WebKit 4.8 (2012年から)
• Flexboxをサポートしていません
• CSSグリッドのサポートなし
• 壊れたJavaScriptの実行
• ES6+はサポートしません。

RotativaとIronPDFの比較

2025年と2026年まで.NET 10とC# 14の採用を計画しているチームにとって、IronPDFはRotativaでは提供できない最新のChromiumレンダリングとクロスプラットフォームのサポートを提供します。

前提条件

1..NET環境: .NET Framework 4.6.2+ または .NET Core 3.1+ / .NET 5/6/7/8/9+. 2.NuGetアクセス：NuGetパッケージをインストールする能力。 3.IronPDFライセンス：ironPdf.comからライセンスキーを取得してください。

NuGetパッケージの変更

# Remove Rotativa
dotnet remove package Rotativa
dotnet remove package Rotativa.AspNetCore

# Install IronPDF
dotnet add package IronPdf

# Remove Rotativa
dotnet remove package Rotativa
dotnet remove package Rotativa.AspNetCore

# Install IronPDF
dotnet add package IronPdf

wkhtmltopdfバイナリの削除

プロジェクトからこれらのファイルを削除してください：

• <コード>wkhtmltopdf.exe</コード
• <コード>wkhtmltox.dll</コード
• すべての Rotativa/<//code> フォルダー

これらはCVE-2022-35583のソースです。IronPDFはネイティブバイナリを必要としません。

ライセンス構成

// Add in Program.cs or Startup.cs
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add in Program.cs or Startup.cs
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

名前空間の変更

// Before: Rotativa
using Rotativa;
using Rotativa.Options;
using Rotativa.AspNetCore;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

// Before: Rotativa
using Rotativa;
using Rotativa.Options;
using Rotativa.AspNetCore;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

IRON VB CONVERTER ERROR developers@ironsoftware.com

コア クラス マッピング

ページのプレースホルダーの変換

例1: HTMLからPDFへの変換

翻訳前(Rotativa):

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

            //ロータティバrequires 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>";

            //ロータティバrequires 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

翻訳後（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
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

この例は、基本的なアーキテクチャの違いを示しています。 Rotativaは、MVCコントローラのアクションからViewAsPdfの結果を返す必要があり、ASP.NET MVCフレームワークと結びついています。 このパターンはMVCリクエストパイプライン内でのみ動作し、レンダリングにはRazorビューが必要です。

IronPDFはコンソールアプリケーション、ウェブAPI、Blazor、Razor Pages、.NETプロジェクトのどのタイプでも動作します。 HTML文字列でRenderHtmlAsPdf()を呼び出し、結果を保存します。 MVCコントローラ不要、ビュー依存なし。 包括的な例については、HTML to PDF documentationを参照してください。

例2: URLからPDFへの変換

翻訳前(Rotativa):

// 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()
        {
            //ロータティバworks 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()
        {
            //ロータティバworks 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

翻訳後（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
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

RotativaのUrlAsPdfクラスは、MVCコントローラからActionResultを返す必要があります。 IronPDFのRenderUrlAsPdf()メソッドはどのようなコンテキストからでも呼び出すことができ、PdfDocumentオブジェクトを直接返します。 URLレンダリングには、wkhtmltopdfの脆弱で時代遅れのWebKitエンジンではなく、最新のChromiumを使用しています。詳しくはチュートリアルをご覧ください。

例3：ページ番号を含むヘッダーとフッター

翻訳前(Rotativa):

// 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

翻訳後（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
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

Rotativaは、[page]や[toPage]のようなプレースホルダーによるヘッダーやフッターの設定を含め、CustomSwitches<//code>を使ってコマンドライン引数をwkhtmltopdfに渡します。 この文字列ベースのアプローチは、エラーが発生しやすく、コンパイル時に検証するのが困難です。

IronPDFはCenterTextやDrawDividerLineのようなプロパティを持つ強い型付けのTextHeaderFooterオブジェクトを使用します。 プレースホルダの構文は、[page]から{page}に、[toPage]から{total-pages}に変更されます。 型付きプロパティはインテリセンス、コンパイル時チェックを提供し、タイプミスのリスクはありません。

PDFマージ

var merged = PdfDocument.Merge(pdf1, pdf2, pdf3);
merged.SaveAs("complete.pdf");

var merged = PdfDocument.Merge(pdf1, pdf2, pdf3);
merged.SaveAs("complete.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

デジタル署名

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password");
pdf.Sign(signature);

IRON VB CONVERTER ERROR developers@ironsoftware.com

パスワード保護

pdf.SecuritySettings.UserPassword = "secret";

pdf.SecuritySettings.UserPassword = "secret";

IRON VB CONVERTER ERROR developers@ironsoftware.com

ウォーターマーク

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

pdf.ApplyWatermark("<h1 style='color:red; opacity:0.3;'>DRAFT</h1>");

IRON VB CONVERTER ERROR developers@ironsoftware.com

PDF/Aアーカイブ準拠

pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);

pdf.SaveAsPdfA("archive.pdf", PdfAVersions.PdfA3b);

IRON VB CONVERTER ERROR developers@ironsoftware.com

最新の CSS サポート

// 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)
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!

IRON VB CONVERTER ERROR developers@ironsoftware.com

移行前

• [コードベース内のすべてのロータティバの使用法を特定する。
• [ ] Document CustomSwitchesは、RenderingOptionsへの変換に使用されます。
• [[page] → {page}）。
• [ironpdf.comからIronPDFライセンスキーを入手してください。

パッケージの変更

• [ ] RotativaとRotativa.AspNetCore NuGetパッケージを削除する。
• [ ]wkhtmltopdfバイナリ（wkhtmltopdf.exe、wkhtmltox.dll）を削除する。
• [ ] IronPdf NuGetパッケージをインストールしてください。

コードの変更

• [ ] 名前空間のインポートを更新する (using Rotativa; → using IronPdf;)
• [ViewAsPdf を<コード>ChromePdfRenderer</コード+ RenderHtmlAsPdf() に置き換えてください。
• [ ] UrlAsPdfをRenderUrlAsPdf()に置き換えてください。
• [ ] CustomSwitches を RenderingOptions プロパティに変換してください。
• [ ] プレースホルダーの構文を更新 ([page] → {page},<コード>[トップページ]</コード→ {total-pages})
• [ ] PageMargins を個々の MarginTop/MarginBottom/MarginLeft/MarginRight に置き換えてください。
• [適宜、asyncパターンに変更してください。
• [アプリケーション起動時のライセンス初期化機能の追加

移行後

• [すべての PDF 生成が正しく動作することを確認してください。
• [PDF出力品質の比較（Chromiumの方が正確にレンダリングされる）
• [ ] CSSレンダリングの改善を確認する（Flexbox/Gridが動作するようになった）
• [JavaScript の実行をテストする（Chromium で信頼できるようになりました）。
• [ ] セキュリティ・スキャンがパスしたことを確認する（CVE-2022-35583 フラグがなくなったこと）。
• [ ] Docker設定を更新してwkhtmltopdfのインストールを削除する