C#でRotativaからIronPDFに移行する方法

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

名前空間の変更

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

コア クラス マッピング

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

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

翻訳後（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!");
        }
    }
}

この例は、基本的なアーキテクチャの違いを示しています。 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
            };
        }
    }
}

翻訳後（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!");
        }
    }
}

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

翻訳後（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!");
        }
    }
}

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

デジタル署名

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

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

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

PDF/Aアーカイブ準拠

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

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

最新の 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!

移行前

• コードベースでロータティバの使用箇所をすべて特定する
• RenderingOptions への変換に使用されるドキュメント CustomSwitches
• 変換のためのヘッダー/フッターのプレースホルダー構文に注意してください（<コード>[ページ]</コード→<コード>{ページ}</コード）
• 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プロパティに変換する
• プレースホルダー構文を更新（<コード>[ページ]</コード→<コード>{ページ}</コード、<コード>[トップページ]</コード→<コード>{総ページ数}</コード）
• PageMargins個別のMarginTop / MarginBottom / MarginLeft / MarginRightに置き換えます
• 必要に応じて非同期パターンに変更する
• アプリケーションの起動時にライセンスの初期化を追加

移行後

• すべてのPDF生成が正しく機能することを確認する
• PDF出力品質の比較（Chromiumの方が正確にレンダリングされる）
• CSS レンダリングの改善を検証 (Flexbox/Grid が動作するようになりました)
• JavaScript 実行をテストする (Chromium で信頼性が向上)
• セキュリティスキャンのパスを検証する（CVE-2022-35583フラグはなくなりました）
• Docker構成を更新してwkhtmltopdfのインストールを削除します