1. IronPDF
  2. 如何使用
  3. 在 .NET MAUI 中檢視 PDF 檔案

在 MAUI for C# .NET 中查看 PDF

Jordi Bardia
Jordi Bardia
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 檢視器橫幅

在當今跨平台開發的時代，讓使用者能夠直接在應用程式內查看 PDF 文件不僅是一種便利，更是一種必需。 使用IronPDF Viewer ，您可以將 PDF 檢視功能嵌入到您的 MAUI 應用程式中。

在本文中，我們將學習如何將IronPDF Viewer整合到 MAUI 應用程式中，以便使用者能夠檢視、儲存和列印 PDF 文件。

快速入門：使用 IronPDF 在 MAUI 中查看 PDF

輕鬆將 IronPDF 整合到您的 MAUI 應用程式中，即可輕鬆查看 PDF 文件。 這段簡單的程式碼片段示範如何實例化 IronPDF PdfViewer 並載入 PDF 檔案以立即查看。 非常適合希望在不增加複雜性的前提下增強應用程式 PDF 查看功能的開發人員。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案：

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

    new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };

  3. 部署到您的生產環境進行測試

    立即開始在您的專案中使用 IronPDF，免費試用！
    arrow pointer

最小工作流程（5 個步驟）

  1. 下載並安裝 IronPDF Viewer 庫
  2. 将IronPDF Viewer集成到MAUI应用程序中
  3. 透過新增 XAML 或 C# 內容頁面來新增 PDF 檢視器頁面。
  4. 啟動時透過檔案名稱、位元組數組和流載入 PDF 檔案。
  5. 配置工具栏


下載並安裝 IronPDF 檢視器庫

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步：
green arrow pointer

Visual Studio - NuGet 套件管理器

在 Visual Studio 中，以滑鼠右鍵按一下解決方案資源管理器中的項目，然後選擇Manage NuGet Packages... 。 從那裡，您可以搜尋IronPdf.Viewer.Maui ，並將最新版本安裝到您的解決方案中。 或者，您也可以透過導覽至Tools > NuGet Package Manager > Package Manager Console並輸入以下命令來開啟 NuGet 套件管理器控制台：

Install-Package IronPdf.Viewer.Maui

將 IronPDF Viewer 整合到 MAUI 應用程式中

在接下來的章節中，我們將示範如何將 IronPDF Viewer 整合到預設的 MAUI 應用程式中。

設定

在將 IronPDF Viewer 新增至 MAUI 專案之前，請確保它不面向 iOS 和 Android 平台。 您可以透過右鍵單擊專案文件並選擇"屬性"來檢查這一點。 如果尚未取消選取"目標平台為 iOS"和"目標平台為 Android"複選框，請取消選取它們。 若要成功實施此更改，您可能需要在取消選取後儲存專案並重新啟動 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
$vbLabelText   $csharpLabel

預設情況下，IronPDF Viewer 會在視圖的右下角顯示一個橫幅。 若要移除此視圖，請依下列方式將您的 IronPDF（或 Iron Suite）授權金鑰新增至ConfigureIronPdfViewer ：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

新增 PDF 檢視器頁面

在本節中，我們將學習如何建立 PDF 檢視器頁面、整合 IronPDF 檢視器，並在 MAUI 應用程式中為其建立一個標籤。 我們將示範如何使用 XAML 和 C# ContentPage來實現這一點。

步驟

  1. 右鍵點選項目，然後選擇Add &gt; New Item...即可新增頁面新增頁面到項目。 新增項目

  2. 導航至.NET MAUI部分。 若要建立 XAML 頁面，請選擇.NET MAUI ContentPage (XAML) 。 對於 C# 文件，請選擇.NET MAUI ContentPage (C#) 。 將檔案命名為 PdfViewerPage，然後按一下Add 。 ! .NET MAUI ContentPage

  3. 在 XAML 檔案中新增以下程式碼並儲存：
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-1.xml
<?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

如果您建立的是 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
$vbLabelText   $csharpLabel
  1. 在您的 AppShell.xaml 檔案中新增以下內容：
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-2.xml
<?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
  1. 儲存項目，然後建置並執行。 您應該會在左上角看到如下圖所示的選項卡，點擊"PDF 檢視器"標籤即可開啟 IronPDF 檢視器。

IronPDF Viewer 預設設定

啟動時載入 PDF

應用程式啟動時，IronPDF Viewer 預設會提示使用者開啟一個 PDF 檔案。 它還可以設定在啟動時自動開啟 PDF 檔案。 啟動時可以透過三種方式載入 PDF：透過檔案名稱、透過位元組數組和透過流。

按檔案名稱載入

若要依檔案名稱載入 PDF 文件，可以在 XAML 文件中的IronPdfView標籤內指定 PDF 文件的來源。範例如下：

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-3.xml
<?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

或者，您也可以在 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")
$vbLabelText   $csharpLabel

透過位元組數組加載

在某些情況下，可能需要載入 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"))
$vbLabelText   $csharpLabel

透過串流加載

同樣地，在某些使用場景下，透過串流載入 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"))
$vbLabelText   $csharpLabel

配置工具列

使用 IronPDF Viewer，您可以選擇要在工具列中顯示的選項。 可選方案有：

  • 縮圖視圖
  • 檔案名稱顯示
  • 文字搜尋 頁碼導航
  • 飆漲
  • 適合寬度
  • 適合身高 順時針旋轉
  • 逆時針旋轉 開啟文件 下載文件
  • 列印文件
  • 顯示註釋
  • 兩頁視圖

預設情況下，IronPDF Viewer 將顯示如下所示的工具列：

預設工具列

預設檢視中，檔案名稱顯示、文字搜尋和逆時針旋轉選項均停用。 若要顯示所有內容，請將 XAML 中IronPdfView標籤的Option參數設為All ：

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-4.xml
<?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>
XML

或者，您也可以用 C# 實現相同的功能：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
$vbLabelText   $csharpLabel

將顯示以下內容：

！所有工具列

如果您不想顯示任何內容，請將選項設為None 。 如果將Options設定為以下值，則工具列將不會顯示：

無工具列

您可以選擇要顯示的特定選項。 例如，如果您只想顯示縮圖和開啟檔案選項，請如下修改 XAML 中IronPdfView的Options參數：

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-5.xml
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

同樣地，在 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
$vbLabelText   $csharpLabel

將顯示以下內容：

帶有縮圖和打開文件選項的工具列

結論

在本教學中，我們學習如何將 IronPDF Viewer 整合到 MAUI 應用程式中，以及如何自訂其工具列以更好地滿足您的需求。

此檢視器隨我們的 IronPDF 產品一起提供。 如果您想提出功能請求或對 IronPDF Viewer（或 IronPDF）有任何一般性問題，請聯絡我們的支援團隊。 我們非常樂意為您提供協助。

常見問題解答

如何在 MAUI 應用程式中檢視 PDF？

若要在 MAUI 應用程式中檢視 PDF，您可以從 Visual Studio 中的 NuGet 套件管理員安裝 IronPDF Viewer，並將所需的程式碼加入專案中，以整合 IronPDF Viewer。

在 MAUI 應用程式中整合 PDF Viewer 需要哪些步驟？

確保您的 MAUI 專案相容，透過 NuGet 下載 IronPDF Viewer 函式庫，並使用您的 IronPDF 授權金鑰在您的 _MauiProgram.cs_ 檔案中初始化檢視器。

如何在 MAUI 應用程式啟動時載入 PDF 檔案？

您可以透過在 XAML 檔案中設定來源，或在 C# ContentPage 中使用 IronPdfViewSource.FromFile, FromBytes 或 FromStream 等方法，在啟動時載入 PDF。

如何自訂 PDF Viewer for MAUI 的工具列？

透過在 XAML 或 C# 程式碼中設定「選項」參數來自訂工具列，以包含縮圖檢視、文字搜尋、縮放等功能，或設定為「全部」以取得完整功能。

是否可以隱藏 MAUI PDF Viewer 中的工具列？

是的，只要將「選項」參數設定為「無」，您就可以隱藏工具列，防止工具列顯示任何工具。

MAUI 中的 PDF 檢視器有哪些常見的故障排除步驟？

確保 IronPDF Viewer 已經透過 NuGet 正確安裝，檢查您的專案相容性，並確認任何必要的程式碼（例如授權金鑰初始化）已在您的專案檔案中正確執行。

我可以在針對 iOS 或 Android 的 MAUI 應用程式中使用 PDF Viewer 嗎？

IronPDF Viewer 目前不支援針對 iOS 或 Android 平台的 MAUI 專案。請確保您的專案以相容的平台為目標。

如何提出功能需求或取得 PDF Viewer 的支援？

如需功能請求或支援，請透過 IronPDF 官方網站聯絡 IronPDF 支援團隊，以取得 PDF Viewer 的協助。

IronPDF Viewer 是否與 MAUI 專案中的 .NET 10 相容？

是的 - IronPDF 與 .NET 10 完全相容，就像與 .NET 6、.NET 7 和 .NET Core 等早期版本相容一樣。這包括在針對 .NET 10 的 MAUI 應用程式中使用 IronPDF，而不需要特殊的設定或變通。

Jordi Bardia
Jordi Bardia
  立即與工程團隊聊天
軟體工程師
Jordi 在 Python、C# 和 C++ 上最得心應手，當他不在 Iron Software 展現技術時，便在做遊戲編程。在分担产品测测试，产品开发和研究的责任时，Jordi 为持续的产品改进增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大，曾在佛罗里达大学学习计算机科学和统计学。
準備好開始了嗎？
Nuget 下載 16,493,056 | Version: 2025.11 剛發表