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

PdfiumViewerを理解する

PdfiumViewerは、Chromeブラウザで使用されているGoogleのPDFレンダリングエンジンであるPDFiumの.NETラッパーです。 Windows Formsアプリケーションに直接PDF表示を統合し、高性能で忠実度の高いPDFレンダリング機能を提供する、シンプルかつ強力なソリューションを提供します。

ただし、PdfiumViewerはあくまでもビューアであることを忘れてはなりません。 PDFの作成、編集、操作には対応していないため、閲覧機能以上のものを必要とするアプリケーションには制限があるかもしれません。 さらに、メンテナンス状況が不明確であるため、プロダクションアプリケーションのリスクが生じます。

PdfiumViewerの重要な制限事項

1.表示のみの機能: HTML、画像、またはプログラムから PDF を作成することはできません。 PdfiumViewerの機能はPDFの閲覧に限定されており、IronPDFのようなライブラリとは異なり、PDFの作成、編集、結合、その他の操作機能はサポートしていません。

2. Windows フォーム固有:このライブラリは Windows フォーム アプリケーションに重点を置いており、他のユーザー インターフェイス フレームワークはサポートしていません。

3. PDF 操作不可: PDF コンテンツを結合、分割、または変更することはできません。

4.ネイティブ バイナリ依存関係:プラットフォーム固有の PDFium バイナリ (x86 および x64 pdfium.dll ファイル) が必要です。

5.不確実なメンテナンス:アップデートが制限されており、長期的なサポートが不明確です。

6.テキスト抽出機能なし:PdfiumViewerにはテキスト抽出機能が組み込まれていないため、OCR または別のライブラリを使用する必要があります。 ページを画像としてレンダリングすることしかできません。

7. HTML から PDF への変換機能はありません。PdfiumViewerは主に PDF ビューア/レンダラーであり、ジェネレーターではありません。 HTMLを直接PDFに変換することはできません。 wkhtmltopdfなどの別のライブラリを使用する必要があります。

8.ヘッダー/フッターなし:ページ番号や繰り返しコンテンツを追加できません。

9.透かしなし:オーバーレイ付きの文書にスタンプを押すことはできません。

10.セキュリティ機能なし: PDF を暗号化したりパスワードで保護したりできません。

PdfiumViewerとIronPdfの比較

2025年と2026年まで.NET 10とC# 14の採用を計画しているチームにとって、IronPDFはWindowsフォームの制限とネイティブバイナリの複雑さを排除し、すべての.NETアプリケーションタイプで動作する包括的でアクティブにメンテナンスされた基盤を提供します。

前提条件

1. .NET 環境:.NET フレームワーク4.6.2+ または .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGetアクセス: NuGetパッケージをインストールする機能
3. IronPDFライセンス: ironpdf.comからライセンスキーを取得します。

NuGetパッケージの変更

# RemovePdfiumViewerpackages
dotnet remove package PdfiumViewer
dotnet remove package PdfiumViewer.Native.x86.v8-xfa
dotnet remove package PdfiumViewer.Native.x64.v8-xfa

# Install IronPDF
dotnet add package IronPdf

# RemovePdfiumViewerpackages
dotnet remove package PdfiumViewer
dotnet remove package PdfiumViewer.Native.x86.v8-xfa
dotnet remove package PdfiumViewer.Native.x64.v8-xfa

# Install IronPDF
dotnet add package IronPdf

ライセンス構成

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

PdfiumViewerの使用法を特定する

# FindPdfiumViewerusage
grep -r "PdfiumViewer\|PdfViewer\|PdfDocument\.Load" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|Native\.x86\|Native\.x64" --include="*.csproj" .

# Find viewer control usage
grep -r "PdfViewer" --include="*.cs" --include="*.Designer.cs" .

# FindPdfiumViewerusage
grep -r "PdfiumViewer\|PdfViewer\|PdfDocument\.Load" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|Native\.x86\|Native\.x64" --include="*.csproj" .

# Find viewer control usage
grep -r "PdfViewer" --include="*.cs" --include="*.Designer.cs" .

名前空間の変更

// PdfiumViewer
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

// PdfiumViewer
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

コア クラス マッピング

ドキュメント読み込みマッピング

ドキュメント プロパティのマッピング

ページ レンダリング マッピング

ドキュメント マッピングの保存

PdfiumViewerでは利用できない新機能

例1: PDFからのテキスト抽出

翻訳前 (PdfiumViewer):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.Text;

string pdfPath = "document.pdf";

// PDFiumViewer has limited text extraction capabilities
// It's primarily designed for rendering, not text extraction
using (var document = PdfDocument.Load(pdfPath))
{
    int pageCount = document.PageCount;
    Console.WriteLine($"Total pages: {pageCount}");

    // PDFiumViewer does not have built-in text extraction
    // You would need to use OCR or another library
    // It can only render pages as images
    for (int i = 0; i < pageCount; i++)
    {
        var pageImage = document.Render(i, 96, 96, false);
        Console.WriteLine($"Rendered page {i + 1}");
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.Text;

string pdfPath = "document.pdf";

// PDFiumViewer has limited text extraction capabilities
// It's primarily designed for rendering, not text extraction
using (var document = PdfDocument.Load(pdfPath))
{
    int pageCount = document.PageCount;
    Console.WriteLine($"Total pages: {pageCount}");

    // PDFiumViewer does not have built-in text extraction
    // You would need to use OCR or another library
    // It can only render pages as images
    for (int i = 0; i < pageCount; i++)
    {
        var pageImage = document.Render(i, 96, 96, false);
        Console.WriteLine($"Rendered page {i + 1}");
    }
}

翻訳後（IronPDF）：。

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

string pdfPath = "document.pdf";

// Open and extract text from PDF
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Extract text from all pages
string allText = pdf.ExtractAllText();
Console.WriteLine("Extracted Text:");
Console.WriteLine(allText);

// Extract text from specific page
string pageText = pdf.ExtractTextFromPage(0);
Console.WriteLine($"\nFirst page text: {pageText}");

Console.WriteLine($"\nTotal pages: {pdf.PageCount}");

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

string pdfPath = "document.pdf";

// Open and extract text from PDF
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Extract text from all pages
string allText = pdf.ExtractAllText();
Console.WriteLine("Extracted Text:");
Console.WriteLine(allText);

// Extract text from specific page
string pageText = pdf.ExtractTextFromPage(0);
Console.WriteLine($"\nFirst page text: {pageText}");

Console.WriteLine($"\nTotal pages: {pdf.PageCount}");

この例は、基本的な能力のギャップを浮き彫りにしています。PdfiumViewerは、"組み込みのテキスト抽出機能はありません""OCRか他のライブラリを使用する必要があります"と明言しています。 PdfiumViewerでPDFからテキストが必要な場合、画像にレンダリングしてOCRを実行せざるを得ません。

IronPDFはExtractAllText()でドキュメント全体の、またはExtractTextFromPage(index)で特定のページのネイティブテキスト抽出を提供します。 OCRも回避策もなく、PDFコンテンツから直接テキストを抽出します。 追加オプションについては、テキスト抽出のドキュメントを参照してください。

例2: HTMLからPDFへの変換

翻訳前 (PdfiumViewer):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// PDFiumViewer is primarily a PDF viewer/renderer, not a generator
// It cannot directly convert HTML to PDF
// You would need to use another library to first create the PDF
// Then use PDFiumViewer to display it:

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// This functionality is NOT available in PDFiumViewer
// You would need a different library like wkhtmltopdf or similar
// PDFiumViewer can only open and display existing PDFs:

string existingPdfPath = "output.pdf";
using (var document = PdfDocument.Load(existingPdfPath))
{
    // Can only render/display existing PDF
    var image = document.Render(0, 300, 300, true);
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// PDFiumViewer is primarily a PDF viewer/renderer, not a generator
// It cannot directly convert HTML to PDF
// You would need to use another library to first create the PDF
// Then use PDFiumViewer to display it:

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// This functionality is NOT available in PDFiumViewer
// You would need a different library like wkhtmltopdf or similar
// PDFiumViewer can only open and display existing PDFs:

string existingPdfPath = "output.pdf";
using (var document = PdfDocument.Load(existingPdfPath))
{
    // Can only render/display existing PDF
    var image = document.Render(0, 300, 300, true);
}

翻訳後（IronPDF）：。

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

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// Create a PDF from HTML string
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF
pdf.SaveAs("output.pdf");

Console.WriteLine("PDF created successfully!");

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

string htmlContent = "<h1>Hello World</h1><p>This is a test document.</p>";

// Create a PDF from HTML string
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF
pdf.SaveAs("output.pdf");

Console.WriteLine("PDF created successfully!");

この例は、2つのライブラリの最も重要な機能の違いを示しています。 PdfiumViewerは"この機能はPDFiumViewerでは利用できません""wkhtmltopdfなどの別のライブラリが必要です"と明示しています。

IronPDFはChromePdfRendererを通してネイティブのHTMLからPDFへの変換を提供し、HTML、CSS、JavaScriptの正確なレンダリングのために内部でChromiumエンジンを使用しています。 RenderHtmlAsPdf()メソッドは、HTML文字列を直接PDF文書に変換します。 IronPDFはRenderUrlAsPdf()でURLを、RenderHtmlFileAsPdf()でHTMLファイルをレンダリングすることもできます。 包括的な例については、HTML to PDF documentationを参照してください。

例3: PDFから画像への変換

翻訳前 (PdfiumViewer):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.Drawing;
using System.Drawing.Imaging;

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// PDFiumViewer excels at rendering PDFs to images
using (var document = PdfDocument.Load(pdfPath))
{
    // Render first page at 300 DPI
    int dpi = 300;
    using (var image = document.Render(0, dpi, dpi, true))
    {
        // Save as PNG
        image.Save(outputImage, ImageFormat.Png);
        Console.WriteLine($"Page rendered to {outputImage}");
    }

    // Render all pages
    for (int i = 0; i < document.PageCount; i++)
    {
        using (var pageImage = document.Render(i, 150, 150, true))
        {
            pageImage.Save($"page_{i + 1}.png", ImageFormat.Png);
        }
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.Drawing;
using System.Drawing.Imaging;

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// PDFiumViewer excels at rendering PDFs to images
using (var document = PdfDocument.Load(pdfPath))
{
    // Render first page at 300 DPI
    int dpi = 300;
    using (var image = document.Render(0, dpi, dpi, true))
    {
        // Save as PNG
        image.Save(outputImage, ImageFormat.Png);
        Console.WriteLine($"Page rendered to {outputImage}");
    }

    // Render all pages
    for (int i = 0; i < document.PageCount; i++)
    {
        using (var pageImage = document.Render(i, 150, 150, true))
        {
            pageImage.Save($"page_{i + 1}.png", ImageFormat.Png);
        }
    }
}

翻訳後（IronPDF）：。

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// Open PDF and convert to images
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Convert first page to image
var firstPageImage = pdf.ToBitmap(0);
firstPageImage[0].Save(outputImage);
Console.WriteLine($"Page rendered to {outputImage}");

// Convert all pages to images
var allPageImages = pdf.ToBitmap();
for (int i = 0; i < allPageImages.Length; i++)
{
    allPageImages[i].Save($"page_{i + 1}.png");
    Console.WriteLine($"Saved page {i + 1}");
}

Console.WriteLine($"Total pages converted: {pdf.PageCount}");

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

string pdfPath = "document.pdf";
string outputImage = "page1.png";

// Open PDF and convert to images
PdfDocument pdf = PdfDocument.FromFile(pdfPath);

// Convert first page to image
var firstPageImage = pdf.ToBitmap(0);
firstPageImage[0].Save(outputImage);
Console.WriteLine($"Page rendered to {outputImage}");

// Convert all pages to images
var allPageImages = pdf.ToBitmap();
for (int i = 0; i < allPageImages.Length; i++)
{
    allPageImages[i].Save($"page_{i + 1}.png");
    Console.WriteLine($"Saved page {i + 1}");
}

Console.WriteLine($"Total pages converted: {pdf.PageCount}");

これは、PdfiumViewerが得意とする分野です。画像へのPDFレンダリングは、PdfiumViewerの最大の強みです。 どちらのライブラリもこのタスクを効果的に処理しますが、パターンは異なります。

PdfiumViewerは、document.Render(pageIndex, dpiX, dpiY, forPrinting)を使用し、適切な処理のためにusingステートメントをネストしています。 ImageFormat列式のために、System.DrawingとSystem.Drawing.Imagingをインポートする必要があります。

IronPdfはビットマップ配列を返すpdf.ToBitmap(pageIndex)を使用します。 ネストされた廃棄要件はなく、よりシンプルなパターンです。 バッチ操作では、パラメータなしのToBitmap()はすべてのページを返します。 RasterizeToImageFiles()を使用して、直接ファイル出力することもできます。 その他のレンダリングオプションについては、PDF to image documentationを参照してください。

ビフォア (PdfiumViewer) - 複雑なデプロイ

MyApp/
├── ビン/
│ ├──MyApp.dll
│ ├──PdfiumViewer.dll
│ ├── x86/
│ └── pdfium.dll
│ └── x64/
└─ pdfium.dll

翻訳後 (IronPDF) - クリーンなデプロイメント

MyApp/
├── ビン/
│ ├──MyApp.dll
│ └─ IronPdf.dll # 含まれるものすべて

ネイティブ バイナリ参照の削除

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj native package references
# <PackageReference Include="PdfiumViewer.Native.x86.v8-xfa" />
# <PackageReference Include="PdfiumViewer.Native.x64.v8-xfa" />

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj native package references
# <PackageReference Include="PdfiumViewer.Native.x86.v8-xfa" />
# <PackageReference Include="PdfiumViewer.Native.x64.v8-xfa" />

組み込みのビューア コントロールはありません

IronPDFはバックエンドに特化しており、ビジュアルPDFビューアコントロールは含まれていません：

// PdfiumViewer: Built-in viewer control
pdfViewer.Document = document;

// IronPDF: Use external viewer or web-based approach
pdf.SaveAs(tempPath);
Process.Start(new ProcessStartInfo(tempPath) { UseShellExecute = true });

// PdfiumViewer: Built-in viewer control
pdfViewer.Document = document;

// IronPDF: Use external viewer or web-based approach
pdf.SaveAs(tempPath);
Process.Start(new ProcessStartInfo(tempPath) { UseShellExecute = true });

閲覧のニーズに対しては、デフォルトのPDFビューアで開くためにProcess.Start()を使用すること、PDFパスを持つWebBrowserコントロール、またはSyncfusion、DevExpress、Telerikのようなサードパーティのビューアコントロールを使用することを検討してください。

ドキュメント読み込み方法の変更

// PdfiumViewer
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// PdfiumViewer
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

保存メソッドの変更

// PdfiumViewer
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// PdfiumViewer
document.Save(path)

// IronPDF
pdf.SaveAs(path)

レンダー メソッドの変更

// PdfiumViewer: Returns image with nested using
using (var image = document.Render(0, 150, 150, true))
{
    image.Save("page.png", ImageFormat.Png);
}

// IronPDF: Returns bitmap array
var images = pdf.ToBitmap(0);
images[0].Save("page.png");

// PdfiumViewer: Returns image with nested using
using (var image = document.Render(0, 150, 150, true))
{
    image.Save("page.png", ImageFormat.Png);
}

// IronPDF: Returns bitmap array
var images = pdf.ToBitmap(0);
images[0].Save("page.png");

ページ サイズ アクセス変更

// PdfiumViewer
var size = document.PageSizes[index];
Console.WriteLine($"{size.Width} x {size.Height}");

// IronPDF
var page = pdf.Pages[index];
Console.WriteLine($"{page.Width} x {page.Height}");

// PdfiumViewer
var size = document.PageSizes[index];
Console.WriteLine($"{size.Width} x {size.Height}");

// IronPDF
var page = pdf.Pages[index];
Console.WriteLine($"{page.Width} x {page.Height}");

移行前

• コードベース内のすべてのPdfiumViewerの使用箇所を特定する
• PdfViewer コントロールを使用して WinForms を一覧表示する
• 現在のレンダリングDPI設定を文書化する
• ネイティブバイナリ参照をチェックする
• 印刷機能の使用状況を特定する
• プランビューアコントロールの置き換え戦略
• IronPDFライセンスキーを取得する

パッケージの変更

• PdfiumViewer NuGet パッケージを削除する
• PdfiumViewer.Native.x86.v8-xfaパッケージを削除します
• PdfiumViewer.Native.x64.v8-xfaパッケージを削除します
• x86/ および x64/ フォルダからネイティブ pdfium.dll バイナリを削除します
• IronPdf NuGet パッケージをインストールします: dotnet add package IronPdf

コードの変更

• 起動時にライセンスキー設定を追加する
• PdfDocument.Load()をPdfDocument.FromFile()に置き換えます
• document.Save()をpdf.SaveAs()に置き換えます
• document.Render()をpdf.ToBitmap()またはRasterizeToImageFiles()に置き換えます
• document.PageSizes[i]をpdf.Pages[i].Width/Heightに置き換えます
• PdfViewer コントロールを外部ビューアまたは Process.Start() に置き換えます
• 新しい機能の追加 (テキスト抽出、HTML から PDF など)

移行後

• レンダリング出力品質のテスト
• 印刷機能のテスト
• ターゲットプラットフォームでのテスト
• 新しい機能の追加（HTMLからPDFへの変換、結合、透かし、セキュリティ）
• ドキュメントの更新