C#NETのMAUIでPDFを表示する

このセクションではPDF Viewerページを作成し、IronPDF Viewerを統合し、MAUIアプリケーションにタブを作成する方法を説明します。 XAMLとC#のContentPageの両方を用いて、このことを示します。 開発スタイルやプロジェクトの要件に最も適したアプローチを選択してください。

ビューア ページを追加する手順は何ですか?

1.プロジェクトを右クリックし、Add > New Item...に移動して、プロジェクトに新しいページを追加してください。 MAUIアプリケーション開発のための新規アイテム、参照、プロジェクトコンポーネントを示すVisual Studioの追加メニュー。

2. .NET MAUI セクションに移動します。 XAML ページを作成するには、.NET MAUI ContentPage (XAML) を選択します。 C# ファイルの場合は、.NET MAUI ContentPage (C#) を選択します。 ファイルに名前 PdfViewerPage を付け、追加 をクリックします。
   .NETのMAUI ContentPage（C#）を選択し、PdfViewerPage.csファイル名を入力したVisual Studioの新規アイテムの追加ダイアログ。

3. 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>

<?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>

代わりにC#のContentPageを作成した場合は、次のコードを追加して保存します：

: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

4._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>

<?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>

5. プロジェクトを保存し、ビルドして実行します。 以下のように、左上にタブが表示されるはずです。 PDF Viewer "タブをクリックするとIronPDF Viewerが開きます。 ビューアは、PDF文書とのインタラクションのための機能豊富なインタフェースを提供します。

ダークテーマでファイルアップロードエリアとファイル参照ボタンを表示したIronPDF Viewerのデフォルトインターフェイス。

アプリケーション起動時にIronPDF Viewerはデフォルトで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>

<?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やWebサービスから受け取ったPDFを扱うとき、PDFのバイト配列を読み込む必要があるかもしれません。 これはXAMLからは不可能ですが、IronPdfViewSource.FromBytesメソッドを使えばC#で実現できます：

: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"))

この方法は、文書管理システムと統合する場合や、IronPDFのHTMLからPDFへの機能を使ってPDFを動的に生成する場合に便利です。

ストリームを通してロードするにはどうすればよいですか?

ストリームを通して読み込まれるPDFについては、特にネットワークリソースを扱う場合やプログレッシブローディングを実装する場合は、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"))

ストリームベースの読み込みは、大きなPDFを効率的に処理したり、暗号化されたドキュメントストリームを扱うのに理想的です。