在 MAUI for C# .NET 中查看 PDF

本節涵蓋如何在 MAUI 應用程式中建立 PDF Viewer 頁面、整合 IronPDF Viewer 並為其建立標籤。 我們使用 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# 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 時，您可能需要載入 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 或處理加密的文件串流。