如何在 C# .NET MAUI 應用程式中檢視 PDF 文件

本節介紹如何在 MAUI 應用程式中建立 PDF 檢視器頁面、整合IronPDF檢視器並為其建立標籤。 我們用 XAML 和 C# 來示範這一點 ContentPage。 選擇最適合您的開發風格和專案需求的方法。

新增檢視器頁面需要哪些步驟？

1. 右鍵點選項目，然後導覽至 Add > New Item...，為專案中新增頁面。
   Visual Studio 新增選單，顯示 MAUI 應用程式開發的"新項目"、"參考"和"專案元件"功能。

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 檢視器"標籤即可開啟IronPDF檢視器。 此檢視器為 PDF 文件互動提供了功能豐富的介面。

應用程式啟動時， IronPDF Viewer 預設會提示使用者開啟一個 PDF 檔案。 但是，它可以在啟動時自動開啟 PDF 文件，這改善了需要立即顯示特定文件的應用程式的使用者體驗。 啟動時可以透過三種方式載入 PDF：透過檔案名稱、透過位元組數組和透過流。 根據資料來源和應用程式架構的不同，每種方法都有其獨特的優勢。

如何透過檔案名稱載入檔案？

若要按文件名稱載入 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 ContentPage。 這種方法為動態檔案載入提供了更大的靈活性：

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

如何透過位元組數組載入資料？

當處理儲存在資料庫中或從 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 文件或處理加密文件流。