IRONPDFの使用

Blazorでバイト配列からPDFを表示する方法

リーガン・パン
リーガン・パン
2023年5月8日
更新済み 2024年3月10日
共有:

1. 序論

IronPDF for C# PDF Solutions and Documentationは、PDFのレンダリングをサポートし、バイト配列をPDFファイルに変換することができるC# PDFライブラリです。 また、PDFのレビューおよび印刷もサポートしています。 また、注釈ツールを使用してPDFをレビューすることもサポートしています。 ヘッダーとフッターの追加や複数のPDFの結合も、IronPDFを使用すると非常に便利です。

IronPDFはBlazor PDFビューアと共に使用してPDFビューアを作成することができ、ブラウザが表示できるオブジェクトURLを作成することで、より大きなファイルサイズを処理することができます。

BlazorでIronPDFを使用することにより、開発者はバイト配列やファイル名からPDFファイルを表示できるPDFビューアを作成できます。さらに、ファイルのアップロードおよびダウンロードの処理もサポートしています。 IronPDFには、PDFドキュメントのページングを処理するためのメソッドもあり、Blazorと問題なく動作します。

さらに、IronPDFはバイト配列をPDFドキュメントに変換するコード例、PDFファイルをダウンロードする例、およびbase64文字列からPDFを表示する例を提供します。 開発者は、PDFファイルを他のファイル形式に変換することもできます。例えば、画像をPDFドキュメントに変換することができます。

IronPDFはBlazorサーバーアプリと共に使用でき、シームレスな開発体験を提供するためにVisual Studioと統合できます。 IronPDF を使用すると、開発者は最新の機能が豊富な Web アプリケーションを構築するためのプロフェッショナルグレードの UI コンポーネントを作成できます。

この記事では、開発者がIronPDFを使用してPDFバイト配列をPDFドキュメントに変換し、Blazor PDFビューアに表示する方法を説明します。

2. 要件

チュートリアルに従うためには、以下のツールと要件が必要です:

  • Visual Studio 2019以降:Blazorアプリケーションを作成して実行するには、これが必要です。 Visual Studio公式ウェブサイトからダウンロードできます
  • .NET 5.0以降:これはBlazorアプリケーションをビルドおよび実行するために必要です。 それは公式の.NETダウンロードページからダウンロードできます
  • IronPDF: これは、PDFバイト配列をPDFドキュメントに変換し、Blazor PDFビューアで表示するために使用されるプロフェッショナルグレードのUIライブラリです。 IronPDF公式ウェブサイトからダウンロードできます
  • IronPDF.Blazor NuGet パッケージ: これは、BlazorアプリケーションにIronPDFを統合するために使用されるNuGetパッケージです。 それはVisual Studio内のNuGetパッケージマネージャーからインストールできます。

    チュートリアルで説明されている一部の機能は、IronPDFの有料版が必要となる場合があります。 また、チュートリアルではBlazorおよびC#の基本的な理解を前提としています。

Blazorアプリケーションの作成

最初のBlazorアプリを構築し始める前に、新しいVisual Studioプロジェクトを作成する必要があります。

  • Visual Studioを開きます。
  • 「Create a New Project」をクリックしてください。
  • Blazor Server App テンプレートを選択する必要があります。

    Blazorでバイト配列からPDFを表示する方法、図1: Visual Studioで新しいプロジェクトを作成する

    Visual Studioで新しいプロジェクトを作成する

  • 次のオプションを選択してください。
  • アプリケーションの名前。

    Blazorでバイト配列からPDFを表示する方法、図2: Visual Studioで新しいプロジェクトを作成する

    Visual Studioで新しいプロジェクトを作成する

  • 次のオプションを選択してください。
  • .NETフレームワークを選択

    Blazorでバイト配列からPDFを表示する方法、図3: 新しいBlazorサーバーアプリ用に.NET 6.0 Frameworkを選択する

    新しい Blazor Server アプリのための .NET 6.0 フレームワークの選択

  • 作成ボタンをクリックします。
  • 以下のように、新しいプロジェクトが作成されます。

    Blazorでバイト配列からPDFを表示する方法、図4: Blazorとは何か、またその仕組み

    Blazorとは何か、そしてそれがどのように機能するか

    使いやすいBlazorソフトウェアを提供するために、いくつかのファイルが作成されました。

  • サーバーを起動するアプリのエントリーポイントはprogram.csであり、ここでミドルウェアとサービスをアプリ用に設定します。
  • アプリケーションの主要な部分は「App.razor」と呼ばれます。
  • アプリのいくつかのサンプルウェブページは、Pagesディレクトリ内にあります。
  • ローカル開発環境の異なるプロファイル設定は、Propertiesディレクトリにある「launchSettings.json」ファイルで定義されています。 プロジェクトが作成されると、ポート番号が自動的に割り当てられ、このファイルに保存されます。

    テンプレートプログラムを開始します。

Blazorプロジェクトタイプ

Blazorは、Blazor ServerとBlazor WebAssemblyの2つのプロジェクトタイプをサポートします。

前者のタイプはサーバーで実行され、SignalRを使用してブラウザと通信します。 これは、アプリケーションのUIがサーバーでレンダリングされ、ブラウザはサーバーからの更新のみを受信することを意味します。 Blazor Serverは、より大規模なアプリケーションをサポートでき、より多くのユーザーを容易に処理できるという利点があります。

一方、Blazor WebAssemblyアプリケーションは、完全にブラウザ内で実行されるため、サーバーを必要としません。 これにより、これらはより軽量で読み込みが速くなりますが、いくつかの制限があります。例えば、より大きなファイルをサポートできないことです。

このチュートリアルにおいては、PDFファイルの表示や取り扱いが可能になるため、Blazorサーバーアプリケーションを使用することをお勧めします。 また、Blazor ServerはPDFのレビューと印刷をサポートできるため、PDFビューアアプリケーションにとって有用な機能となるかもしれません。

IronPDFのインストール

このセクションでは、さまざまな方法を使用してIronPDFをインストールする方法について説明します。

コマンドラインの使用

Visual Studioでツール > NuGet パッケージ マネージャー > パッケージ マネージャー コンソールに移動します。

パッケージマネージャーのターミナルタブに次の行を入力してください:

Install-Package IronPdf

パッケージをダウンロードしたので、現在のプロジェクトにインストールされます。

Blazorでバイト配列からPDFを表示する方法、図5: パッケージ マネージャー コンソール UI

パッケージマネージャー コンソール UI

ソリューションのNuGetパッケージ管理を使用

NuGet パッケージ マネージャー UI は、Visual Studio 内で使用可能であり、パッケージを直接プロジェクトにインストールするために利用できます。 以下のスクリーンショットは、どのように開くかを示しています。

Blazorでバイト配列からPDFを表示する方法、図6:NuGetパッケージマネージャーへ移動

NuGet パッケージ マネージャーに移動

パッケージ マネージャー UI には、NuGet ウェブサイトで提供されているパッケージ ライブラリのリストを表示する「参照」機能が備わっています。以下のスクリーンショットのように、「IronPDF」というキーワードを入力して、IronPDF パッケージを見つけてください。

Blazorでバイト配列からPDFを表示する方法、図7:NuGetパッケージマネージャーUIでIronPDFパッケージを検索してインストール

NuGet パッケージ マネージャー UI で IronPDF パッケージを検索してインストールする

ブラウズセクションで検索して、NuGetパッケージマネージャーでIronPDFライブラリを見つけます。

IronPDFパッケージを選択し、プロジェクトに追加するために「インストール」ボタンをクリックします。

バイト配列からPDFを作成および表示する

BlazorアプリケーションでIronPDFを使用してPDFバイト配列を生成するには、まずプロジェクトにIronPDF依存関係を追加する必要があります。

BlazorアプリケーションにIronPDF依存関係を追加したら、次のコードを使用してPDFドキュメントを作成できます:

string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

上記のコードスニペットは、まずIronPDFのRenderUrlAsPdf Method Documentationメソッドを使用し、指定されたURLからHTMLテキストをダウンロードしてPDF形式に変換します。 生成されたPDFマテリアルは、その後、コードスニペットによって未処理のbase64データの文字列としてレンダリングされ、ローカル変数に保存されます。

アプリケーションは、作成したPDFファイルをIronPDFのSaveAs関数のドキュメントを使用してサーバーのファイルシステムに保存し、後でアクセスすることができます(すべてのChromePdfRendererインスタンスのドキュメントで利用可能)。

次のコードセクションでクライアントのブラウザに出力するために、base64 PDFデータが準備されています。

@if (_url != string.Empty)
{

}
@if (_url != string.Empty)
{

}

前述の関数は、Blazor サーバーサイドから受け取った base64 データを iframe 要素の src 属性にバインドします。これにより、ブラウザはページが読み込まれるとすぐに組み込みの Web ビューアーを使用して Base64 コンテンツを適切な PDF ドキュメントとしてレンダリングします。

以下は、base64文字列から生成されたPDFファイルの画像です。

Blazorでバイト配列からPDFを表示する方法、図8: ブラウザでBlazorアプリで生成されたPDFを表示する

Blazorアプリで生成されたPDFをブラウザで表示する

シンプルなPDFファイルの作成

以下に、C#でIronPDFを使用して簡単なPDFドキュメントを作成する例のコードスニペットを示します:

var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")

前のセクションで説明した方法を使用すると、クライアントのブラウザで作成されたPDFドキュメントを表示することができます。

結論

このチュートリアルは、Blazor ServerアプリでPDFドキュメントを作成し表示するためのIronPDFの機能とチュートリアルの使用方法を示しています。最初にIronPDFとその機能、例えばHTMLをPDFに変換する方法カスタムヘッダーとフッターを追加する複数のPDFを統合する方法を紹介します。 次に、IronPDFをインストールし、Blazor ServerアプリでPDFファイルを作成し、それをPDFバイト配列に変換し、iframeを使用してBlazor PDFビューアで表示するためのステップバイステップの指示を提供します。

全体として、このチュートリアルはIronPDFとBlazorを使用してPDFドキュメントを作成および表示する方法の包括的な概要を提供します。 それは読者に、IronPDFをさらに試し、さまざまな機能を試して、豊富な機能を備えたアプリケーションを作成することを奨励します。

Blazor プロジェクトで IronPDF を試してみたい場合は、IronPDF の無料体験版を利用できます。 これにより、ライブラリの機能と性能を実験する十分な時間が与えられ、あなたのニーズに合っているかどうかを確認することができます。

開始するには、プロジェクトでライブラリを使用するための詳細情報が記載されているIronPDF Documentation for Blazorをご参照ください。 PDFの操作とレンダリングに関連するさまざまなトピックをカバーしたチュートリアルや記事については、IronPDFのブログとチュートリアルもご覧いただけます。

IronPDFとBlazorをさらに試して、PDF関連の開発をどのように向上させることができるかを確認することをお勧めします。 Blazor PDF ビューアーに関する詳細情報は、次のIronPDF Blazor PDF Viewer Tutorialをご参照ください。

リーガン・パン
ソフトウェアエンジニア
レーガンはリーディング大学で電子工学の学士号を取得しました。Iron Softwareに入社する前の仕事では、一つのタスクに集中して取り組んでいました。Iron Softwareでは、営業、技術サポート、製品開発、マーケティングのいずれにおいても広範な業務に携わることが最も楽しいと感じています。彼は、Iron Softwareライブラリを開発者がどのように使用しているかを理解し、その知識を使ってドキュメントを継続的に改善し、製品を開発することを楽しんでいます。
< 以前
C#でPDFファイルを保存する方法(初心者向けチュートリアル)
次へ >
PDFのセキュリティを解除する方法(初心者向けチュートリアル)