Blazor PDFビューアーチュートリアル

イントロダクション

Adobeは、フォーマットされたテキストと画像を公開するために広く利用されているポータブルドキュメントフォーマット（PDF）を作成しました。 このチュートリアルでは、PDFを表示するためのBlazorサーバーサイドアプリケーションに統合するのにIronPDFが推奨されています。なぜなら、使いやすく効率的だからです。

1. IronPDFの特徴

強力なIronPDF PDF .NETライブラリの助けを借りて、開発者はPDFドキュメントを簡単に作成、読み取り、および修正することができます。 IronPDF Chromeレンダリングエンジンに基づき、IronPDFは広範囲で有用かつ強力な機能を含んでいます。これには、HTML5、JavaScript、CSS、および画像をPDFに変換する機能、PDFにカスタムヘッダーとフッターを追加する機能、ウェブブラウザで表示される通りにPDFを作成する機能が含まれています。

IronPDFは、HTML、ASPX、Razor View、MVCなどの複数のWeb技術をサポートしています。 以下はIronPDFの主要な特徴です:

• IronPDFは、.NET C# アプリケーション内でPDFファイルの作成および修正を完全にコントロールできます。
• IronPDFは、特定のユーザーエージェント、プロキシ、ヘッダー、クッキーの構成を使用して、URLからウェブページのPDFファイルを生成できます。
• IronPDFは既存のPDFドキュメントから画像を削除できます
• IronPDFは、テキスト、写真、ブックマーク、ウォーターマーク、および他の要素をPDFドキュメントに追加できます。
• IronPDFには、PDFドキュメントを簡単に結合および分割できる複数の機能があります。
• IronPDFはCSSやJavaScriptなどのウェブメディア資産を理解してレンダリングできます。
• IronPDFは、ASP.NETおよびBlazorを含む、さまざまな.NETデスクトップおよびMVC Webアプリケーションフレームワークをサポートしています。

Blazorとは何ですか？

Blazorは、Webアセンブリを使用してC#とHTMLでクライアントサイドのWebアプリケーションを作成することを可能にする実験的なWebアプリケーションフレームワークです。

Web Assemblyアプリは、ほぼネイティブの速度で動作できるバイナリ命令形式でブラウザに送信されます。 これにより、C#のような言語がブラウザ内で実行される可能性が新たに生まれました。

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

まず、Microsoft Visual Studioアプリケーションを開き、ファイルメニューから「新しいプロジェクト」を選択します。 次に、「Blazor サーバーアプリ」を選択してください。

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

プロジェクト名を入力し、ファイルパスを選択してください。 その後、Create ボタンをクリックします。

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

また、希望する .NET Framework を選択してください。 安定性のためには、最新バージョンを使用することをお勧めします。

新しいBlazor Serverアプリに.NET 6.0フレームワークを選ぶ

Microsoft Visual Studio は、新しい Blazor Server App の構造を生成します。このプロジェクトには、ソースコードを入力できる .razor ファイルのコレクションが含まれます。

次のステップでは、プロジェクトにIronPDFライブラリを追加します。

3. IronPDFライブラリのインストール

IronPDFライブラリは、次の4つの方法でダウンロードおよびインストールできます：

• Visual StudioのNuGetパッケージマネージャーを使用
• Visual Studio のコマンドラインの使用
• NuGetウェブサイトから直接ダウンロードする
• IronPDFのウェブサイトから直接ダウンロード

3.1 Visual StudioのNuGetパッケージマネージャーを使う

Visual Studioには、プロジェクトにライブラリを直接インストールするためのNuGetパッケージマネージャーが用意されています。 以下のスクリーンショットは、NuGetパッケージマネージャーを開く方法を示しています。

Visual Studio の NuGet パッケージ マネージャーにアクセスする

以下のスクリーンショットに示されているように、ブラウズタブの検索フィールドを使用して「IronPDF」を検索してください。

NuGet パッケージ マネージャー GUI で IronPDF ライブラリを検索

上記の画像には関連検索結果のリストが表示されています。 プロジェクトにパッケージをインストールするために必要なオプションを選択してください。

3.2 Visual Studio コマンドラインの使用

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

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

Install-Package IronPdf

Install-Package IronPdf

パッケージが現在のプロジェクトにダウンロードおよびインストールされます。

NuGet パッケージ マネージャー コンソールを使用した IronPDF ライブラリのインストール

NuGetウェブサイトから直接ダウンロードする方法

IronPDFライブラリをインストールする3つ目の方法は、ウェブサイトから直接NuGetパッケージをダウンロードすることです。

NuGetのIronPDFパッケージに移動してください。

• 右側のメニューから「Download Package」オプションをクリックします。
• ダウンロードしたパッケージをファイルシステム上で開いてください。 自動的にインストールされます。
• ソリューションをリロードして、プロジェクトで使用を開始します。

IronPDFのウェブサイトから直接ダウンロードする方法

IronPDF公式サイトから最新パッケージをダウンロードしてください。

ダウンロード後、パッケージをプロジェクトに追加するために以下の手順に従ってください。

• ソリューションウィンドウからプロジェクトを右クリックします。
• 「参照」を選択し、その後、以前ダウンロードしたライブラリの場所に移動します。
• ライブラリを参照として追加するには「OK」をクリックしてください。

Blazorサーバーアプリを使用してPDFドキュメントを表示

このチュートリアルで作成するBlazorアプリケーションは、ウェブページのURLからPDFドキュメントを作成し、クライアントのウェブブラウザーにレンダリングします。

IronPDFを使用すると、PDFの表示が簡単になります。

次のソースコードを対応する.razorファイルに追加します。

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

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

Private _imgUrl As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function

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

利便性のために、アプリケーションは生成されたPDFドキュメントをサーバーのファイルシステムに保存して、後で素早くアクセスできるようにするには、IronPDFのSaveAsメソッド（ChromePdfRendererインスタンスで利用可能）を使用できます。

次のコードセグメントは、クライアントのブラウザに出力するためのbase-64 PDFデータを準備します。

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_imgUrl != string.Empty)
Private Sub New(Optional _imgUrl (Not ByVal) As = String.Empty)
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
	"width:750px;height:750px;" type="application/pdf"/>
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type
	"@_imgUrl" style="width:750px;height:750px;" type
	<iframe src="@_imgUrl" style
End Sub

上記の関数はBlazorのサーバーサイドからbase64データを受け取り、それをiframe要素のsrc属性にバインドします。 ページの読み込み時に、ブラウザはビルトインビューアを使用してbase64コンテンツを適切なPDFドキュメントとしてレンダリングします。

以下は、base64文字列からレンダリングされたPDFファイルのスクリーンショットです。

![Blazor PDF ビューワーチュートリアル、図 7: ブラウザーでBlazorアプリで生成されたPDFを表示。] このPDFはIronPDFによって作成され、base64文字列としてブラウザに送信されました。

Blazorアプリで生成されたPDFをブラウザで表示する。 このPDFはIronPDFによって作成され、base64文字列としてブラウザに送信されました。**

HTML文字列からPDFドキュメントを表示

以下は、IronPDFがHTMLタグの文字列からPDFファイルを作成する方法の例です。

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var pdf = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

生成されたPDFドキュメントは、前のセクションに詳述された手順を使用してクライアントのブラウザから表示することができます。

結論

この記事では、IronPDFライブラリを使用してWebページからPDFファイルを生成し、ユーザーのブラウザに表示するBlazor Webアプリケーションの開発方法を紹介しました。

IronPdfはオープンソースではありません； ただし、無料試用キーを使用すると、透かしなしで本番環境で使用することができます。