Viewing PDFs in MAUI for C# .NET

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

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

1. プロジェクトを右クリックして新しいページを追加し、Add > New Item... に移動します。
   

2. .NET MAUI セクションに移動します。 XAML ページを作成するには、.NET MAUI ContentPage (XAML) を選択します。 C# ファイルの場合は、.NET MAUI ContentPage (C#) を選択します。 ファイルに PdfViewerPage という名前を付け、Add をクリックします。
   

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はデフォルトで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# の 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 からは不可能ですが、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"))

この方法は、文書管理システムと統合する場合や、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を効率的に処理したり、暗号化されたドキュメントストリームを扱うのに理想的です。