C# .NETのMAUIにおけるPDFの表示
クロスプラットフォーム開発の現代において、ユーザーがアプリ内で直接PDFドキュメントを表示できる機能を提供することは、単なる便利さではなく、必要不可欠です。 IronPDF Viewerを使用すると、PDF閲覧機能をMAUIアプリケーションに埋め込むことができます。
この記事では、ユーザーがPDFを表示、保存、および印刷できるようにするために、MAUIアプリケーション内で IronPDF Viewer を統合する方法について学びます。
概要
C# .NET MAUIアプリでPDFを表示する方法
- IronPDFビューアライブラリをダウンロードしてインストールしてください
- MAUIアプリケーションにIronPDF Viewerを統合する
- XAML または C# ContentPage を追加して、PDF ビューア ページを追加します。
- ファイル名、バイト配列、およびストリームを使用してスタートアップ時にPDFを読み込む
- ツールバーを構成する
IronPDFビューワーライブラリをダウンロードしてインストール
今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。
Visual Studio - NuGetパッケージマネージャー
Visual Studioで、プロジェクトのソリューションエクスプローラーを右クリックし、『NuGet パッケージの管理...』を選択します。そこからIronPdf.Viewer.Mauiを検索し、最新バージョンをソリューションにインストールします。 または、ツール > NuGet パケット マネージャー > パッケージ マネージャー コンソールに移動し、NuGet パッケージ マネージャー コンソールを開いて、次のコマンドを入力することもできます:
Install-Package IronPdf.Viewer.Maui
MAUIアプリケーションにIronPDF Viewerを統合する
以下のセクションでは、デフォルトのMAUIアプリケーションにIronPDFビューアを統合する方法を示します。
セットアップ
MAUIプロジェクトにIronPDF Viewerを追加する前に、まずiOSおよびAndroidプラットフォームを対象としていないことを確認してください。 プロジェクトファイルを右クリックして「プロパティ」を選択することでこれを確認できます。 以下の画像で下線が引かれている、Target the iOS Platform および Target the Android platform のチェックボックスが既にチェックされていない場合は、チェックを外してください。 この変更を正常に実装するためには、チェックを外した後プロジェクトを保存し、Visual Studioを再起動する必要があるかもしれません。
iOSとAndroidプラットフォームのターゲットを解除した後、_MauiProgram.cs_ファイルに以下のコードを追加してビューアを初期化します：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.csusing IronPdf.Viewer.Maui;
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
// other configuration options ...
.ConfigureIronPdfView(); // configure the viewer on app start-up
return builder.Build();
}
}Imports IronPdf.Viewer.Maui
Public Module MauiProgram
Public Function CreateMauiApp() As MauiApp
Dim builder = MauiApp.CreateBuilder()
builder.UseMauiApp(Of App)().ConfigureIronPdfView() ' configure the viewer on app start-up
Return builder.Build()
End Function
End Moduleデフォルトでは、IronPDF Viewerはビューの右下にバナーを表示します。 このビューを削除するには、IronPDF を追加してください(または Iron Suite)ConfigureIronPdfView にライセンスキーを次のように渡します:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs.ConfigureIronPdfView("YOUR-LICENSE-KEY");IRON VB CONVERTER ERROR developers@ironsoftware.comPDFビューアーページを追加
このセクションでは、PDFビューワーページの作成、IronPDF Viewerの統合、およびMAUIアプリケーションでのタブの作成方法について学びます。 これをXAMLとC#のContentPageの両方で行う方法を示します。
手順
-
次の手順で新しいページをプロジェクトに追加してください：プロジェクトを右クリックし、「追加 > 新しい項目...」に進みます。
-
次に
.NET MAUIセクションに移動してください。 XAMLページを作成するには、.NET MAUI ContentPageを選択します。(XAML). C＃ファイルの場合、.NET MAUI ContentPageを選択(C#). ファイルに_PdfViewerPage_という名前を付けて、Addをクリックしてください。
- XAMLファイルに以下のコードを追加して保存してください。
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>以下のコードを追加し、保存してください。:
ContentPage 内容 = new ContentPage
{
Title = "ページのタイトル",
Content = new StackLayout
{
Children =
{
new Label { Text = "ようこそ、IronPDF for .NETへ！" },
new Button { Text = "クリックしてください" }
}
}
};ContentPage 内容 = new ContentPage
{
Title = "ページのタイトル",
Content = new StackLayout
{
Children =
{
new Label { Text = "ようこそ、IronPDF for .NETへ！" },
new Button { Text = "クリックしてください" }
}
}
};Dim 内容 As New ContentPage With {
.Title = "ページのタイトル",
.Content = New StackLayout With {
.Children = {
New Label With {.Text = "ようこそ、IronPDF for .NETへ！"},
New Button With {.Text = "クリックしてください"}
}
}
}:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.csusing IronPdf.Viewer.Maui;
public class MainPage : ContentPage
{
private readonly IronPdfView pdfView;
public MainPage()
{
InitializeComponent();
this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };
Content = this.pdfView;
}
}
Imports IronPdf.Viewer.Maui
Public Class MainPage
Inherits ContentPage
Private ReadOnly pdfView As IronPdfView
Public Sub New()
InitializeComponent()
Me.pdfView = New IronPdfView With {.Options = IronPdfViewOptions.All}
Content = Me.pdfView
End Sub
End Class- AppShell.xaml ファイルに、以下を追加してください:
<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
...>
<TabBar x:Name="AppTabBar">
<Tab Title="Home">
<ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
</Tab>
<Tab Title="PDF Viewer">
<ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
</Tab>
</TabBar>
</Shell>-
プロジェクトを保存し、次にビルドして実行してください。 以下のように左上隅にタブが表示されるはずです。「PDF Viewer」タブをクリックすると、IronPDF Viewerが開くはずです。
スタートアップ時にPDFをロード
アプリケーションの起動時、IronPDFビューアはデフォルトでユーザーにPDFを開くように促します。 それが起動時にPDFを自動的に開くことも可能です。 PDFを起動時に読み込む方法は3つあります：ファイル名による方法、バイト配列による方法、およびストリームによる方法です。
ファイル名で読み込む
PDFをファイル名で読み込むには、XAMLファイルの IronPdfView タグでPDFファイルのソースを指定することができます。以下にその例を示します:
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>また、C#のContentPageでIronPdfViewSource.FromFileメソッドを使用して、ファイル名からPDFをロードすることもできます:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");' We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf")バイト配列を介して読み込む
いくつかのユースケースでは、PDFのバイト配列を読み込むことが望ましい場合があります。 これはXAMLでは不可能ですが、C#では可能です。 この目的を達成するには、 IronPdfViewSource.FromBytes メソッドを使用するだけです。 このメソッドの使用方法の例を以下に示します:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cspdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))ストリームを介して読み込み
同様に、いくつかの使用事例では、PDFをストリームを通してロードすることがより望ましい場合があります。 これはXAMLでは不可能ですが、C#では可能です。 この操作は、単に IronPdfViewSource.FromStream メソッドを使用することによって達成できます。 このメソッドの使用方法の例を以下に示します:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cspdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))ツールバーの設定
IronPDF Viewerでは、ツールバーに表示するオプションを選択できます。 利用可能なオプションは次のとおりです:
- サムネイル表示
- ファイル名表示
- テキスト検索
- ページ番号ナビゲーション
- ズーム
- 幅に合わせる
- 高さに合わせる
- 時計回りに回転
- 反時計回りに回転
- ファイルを開く
- ファイルをダウンロード
- ファイルの印刷
- 注釈を表示
-
二ページ表示
デフォルトでは、IronPDF Viewerは以下のツールバーを表示します:
デフォルトビューでは、ファイル名の表示、テキスト検索、および反時計回りの回転オプションがすべて無効になっています。 すべてを表示するには、XAML 内の
IronPdfViewタグのOptionパラメーターをAllに設定してください。
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView x:Name="pdfView" Options="All"/>
</ContentPage>代わりに、C#で同じことを達成することもできます:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cspdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.All次のように表示されます:
表示したくない場合は、オプションをNoneに設定してください。 Options がこのように設定されている場合、ツールバーは表示されません:
表示する特定のオプションを選択できます。 例えば、サムネイルとファイルを開くオプションのみを表示したい場合、XAMLでIronPdfViewのOptionsパラメータを次のように変更します:
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>同様に、C#では次のようになります:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open次のように表示されます:
結論
このチュートリアルでは、IronPDF ViewerをMAUIアプリケーションに統合し、ツールバーをニーズに合わせてカスタマイズする方法を学びました。
このビューワーは、IronPDF製品に付属しています。 機能のリクエストをしたい場合やIronPDF Viewerに関する一般的な質問がある場合は(または IronPDF)以下の内容を日本語に翻訳してください：
Iron Softwareは、さまざまな企業に強力かつ柔軟なツールを提供することに注力しています。特に注目すべき製品には、IronPDF、IronOCR、IronXL、IronBarcode、IronQR、IronZIP、IronPrint、IronWord、IronWebScraperが含まれます。これらのツールは、.NET、Java、Python、Node.jsなど複数のプラットフォームで利用でき、ソフトウェア開発プロセスを簡素化し、効率化します。
IronPDF：
IronPDFは、PDFの生成、編集、変換、レンダリングを簡単に行うための強力なライブラリです。スマートなテンプレートと直感的なAPIを利用して効率的なPDF操作を実現します。
IronOCR：
IronOCRは、光学式文字認識（OCR）機能を提供し、スキャンされた文書や画像からテキストを抽出します。高精度な認識機能により、多言語対応も可能です。
IronXL：
IronXLは、Excelファイルの読み取り、作成、編集を行うためのライブラリです。複雑なファイル処理を簡素化し、迅速なデータ操作をサポートします。
IronBarcode：
IronBarcodeは、バーコードの生成と読み取りを行うためのツールです。幅広いバーコード形式に対応し、業務プロセスの自動化に貢献します。
IronQR：
IronQRは、QRコードの生成と読み取りを行うためのライブラリです。高精度で迅速な処理能力により、リアルタイム認識が可能です。
IronZIP：
IronZIPは、圧縮および解凍機能を提供するライブラリです。効率的なデータ圧縮とアーカイブ作成が可能です。
IronPrint：
IronPrintは、プリントタスクの実行を簡素化するツールで、プリントジョブのカスタマイズをサポートします。
IronWord：
IronWordは、Word文書の生成、編集、変換を行うためのライブラリです。さまざまなドキュメントフォーマットの操作が簡単に行えます。
IronWebScraper：
IronWebScraperは、Webデータの抽出と分析を行うためのツールです。効率的なデータ収集とクレンジングを行い、ビジネスインサイトを提供します。
Iron Softwareの製品群は、Lite Licenseから始まり、Plus License、Professional License、Unlimited Licenseまで、さまざまなニーズに対応するライセンスオプションがあります。Iron Suite for .NETやIron Suite Unlimitedなどのパッケージも用意されており、包括的なソリューションを提供します。サポートチームに連絡する. 喜んでお手伝いいたします。
