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.cs
using 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.com
PDFビューアーページを追加
このセクションでは、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.cs
using 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.cs
pdfView.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.cs
pdfView.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.cs
pdfView.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.cs
pdfView.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などのパッケージも用意されており、包括的なソリューションを提供します。サポートチームに連絡する. 喜んでお手伝いいたします。