在 MAUI for C# .NET 中檢視 PDF 檔案
透過 IronPDF Viewer,您可在 MAUI 應用程式中直接檢視 PDF 檔案。此工具提供功能齊全的 PDF 檢視元件,僅需一行程式碼即可透過工具列選項進行導覽、縮放、搜尋及列印。

跨平台應用程式通常需要在應用程式內直接顯示 PDF 文件。IronPDF Viewer 讓您將 PDF 檢視功能嵌入 MAUI 應用程式中,實現跨 Windows 和 macOS 平台的文件檢視。
IronPDF Viewer 是一個基於 IronPDF 函式庫所建構的元件,提供完整的 PDF 處理與檢視解決方案。 它提供與 .NET MAUI 應用程式的原生整合,以確保跨平台的一致效能。
本文將說明如何在 MAUI 應用程式中整合 IronPdf Viewer,讓使用者能夠檢視、儲存及列印 PDF 檔案。 無論您正在開發 Enterprise 應用程式、文件管理系統或教育軟體,本指南都能協助您實作 PDF 檢視功能。
快速入門:在 MAUI 中使用 IronPDF 檢視 PDF 檔案
將 IronPDF 整合至您的 MAUI 應用程式中,即可立即開始檢視 PDF 檔案。 此程式碼片段示範如何建立 IronPDF PdfViewer 的實例,並載入 PDF 檔案以供檢視。
簡化工作流程(5 個步驟)
- 下載並安裝 IronPDF Viewer 函式庫
- 將 IronPDF Viewer 整合至 MAUI 應用程式
- 透過新增 XAML 或 C#
ContentPage來建立 PDF 檢視器頁面 - 在啟動時透過檔案名稱、位元組陣列或串流載入 PDF
- 設定工具列
如何下載並安裝 IronPDF Viewer 函式庫?
如何透過 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 應用程式中檢視 PDF 所需的所有必要依賴項。 它採用與核心 IronPDF 函式庫相同的渲染引擎,以確保文件顯示的準確性。
如何將 IronPDF Viewer 整合至 MAUI 應用程式中?
以下各節將示範如何將 IronPDF Viewer 整合至預設的 MAUI 應用程式中。 整合流程簡單明瞭,且僅需極少的設定。
整合前需要哪些設定?
在將 IronPDF Viewer 加入您的 MAUI 專案之前,請確認該專案未針對 iOS 和 Android 平台進行開發。 目前,IronPDF Viewer 支援 Windows 和 macOS 桌面平台。 請右鍵點擊專案檔案並選擇 Properties 來檢查此內容。 若 Target the iOS Platform 和 Target the Android platform 核取方塊已勾選,請取消勾選。 若要使此變更生效,請取消勾選後儲存專案,並重新啟動 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
預設情況下,IronPDF Viewer 會在檢視畫面右下角顯示一個橫幅。 若要移除此橫幅並解鎖所有功能,請將您的 IronPDF(或 Iron Suite)授權金鑰新增至 ConfigureIronPdfViewer:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
.ConfigureIronPdfView("YOUR-LICENSE-KEY")
有關取得及應用授權金鑰的詳細資訊,請參閱我們的《授權金鑰指南》。
如何新增 PDF 檢視器頁面?
本節說明如何建立 PDF 檢視器頁面、整合 IronPDF Viewer,並在 MAUI 應用程式中為其建立一個分頁。 我們將透過 XAML 和 C# 範例來展示這一點 ContentPage。 請選擇最符合您的開發風格與專案需求的方案。
新增檢視器頁面的步驟有哪些?
-
右鍵點擊您的專案,然後導航至
Add > New Item...以在專案中新增一個頁面
-
導航至
.NET MAUI區段。 要建立 XAML 頁面,請選取.NET MAUI ContentPage (XAML)。 若為 C# 檔案,請選擇.NET MAUI ContentPage (C#)。 請將您的檔案命名為PdfViewerPage,然後點擊Add。
- 在 XAML 檔案中加入以下程式碼並儲存:
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<?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" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<?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>
- 儲存您的專案,然後進行編譯並執行。 您應能在左上角看到如下所示的標籤頁。 點擊"PDF 檢視器"分頁將開啟 IronPDF 檢視器。 此檢視器提供功能豐富的介面,用於與 PDF 文件進行互動。

如何在啟動時載入 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"
...>
<?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="Thumbs, Open"/>
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<?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="Thumbs, Open"/>
同樣地,在 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
顯示內容:
![]()
透過對工具列選項的細部控制,您可打造符合應用程式需求的檢視體驗。 例如,您可以在安全的文件檢視器中限制下載功能,或針對基本的檢視情境簡化介面。
結論
本教學介紹了如何將 IronPDF Viewer 整合至 MAUI 應用程式,並根據需求自訂其工具列。 IronPDF Viewer 提供強大的 PDF 瀏覽體驗,只需少量程式碼即可無縫整合至您的 .NET MAUI 應用程式中。
該檢視器具備從多種來源(檔案、位元組陣列及資料流)載入 PDF 的靈活性,使其適用於多種應用場景,從簡單的文件檢視器到複雜的文件管理系統皆然。 結合豐富的工具列自訂選項,您可以打造出完全符合使用者需求的瀏覽體驗。
此檢視器隨附於我們的 IronPDF 產品中,該產品同時具備強大的 PDF 生成、編輯及處理功能。 若您想提出功能需求,或對 IronPDF Viewer(或 IronPDF)有任何一般性疑問,請聯絡我們的支援團隊。 我們很樂意為您提供協助。
若需進行更進階的 PDF 操作,請參閱我們的完整 PDF 瀏覽指南,或瞭解如何套用授權金鑰,以在您的應用程式中充分發揮 IronPDF 的全部潛力。
常見問題
什麼是 IronPDF Viewer for .NET MAUI?
IronPDF Viewer 是一款功能齊全的 PDF 檢視元件,可讓您將 PDF 檢視功能直接嵌入 MAUI 應用程式中。它提供用於導覽、Zoom、搜尋和列印的工具列選項,且僅需一行程式碼即可實作。此檢視器基於 IronPDF 函式庫建構,提供全面的 PDF 處理與檢視功能。
IronPDF Viewer 在 MAUI 應用程式中支援哪些平台?
IronPDF Viewer 可與 .NET MAUI 應用程式進行原生整合,並支援在 Windows 和 macOS 平台上跨平台檢視 PDF,確保在這些作業系統上表現一致。
如何在我的 MAUI 專案中安裝 IronPDF Viewer.Maui?
您可透過 Visual Studio 中的 NuGet 套件管理員,搜尋 'IronPdf.Viewer.Maui' 並安裝最新版本來安裝 IronPDF Viewer。此外,您亦可透過套件管理員主控台執行 'Install-Package IronPdf.Viewer.Maui' 指令進行安裝。此套件包含在 MAUI 應用程式中檢視 PDF 所需的所有必要依賴項。
我能在多快的時間內將 PDF 檢視功能實作到我的 MAUI 應用程式中?
IronPDF Viewer 讓您只需一行程式碼,即可嵌入功能齊全的 PDF 檢視器:new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };。這使得您能極快地為 MAUI 應用程式增添 PDF 檢視功能。
PDF 檢視器工具列提供哪些功能?
IronPDF Viewer 工具列提供全面的功能,包括用於在頁面間切換的導覽控制項、用於調整文件檢視大小的 Zoom 功能、用於在 PDF 中搜尋文字的搜尋功能,以及可直接從您的 MAUI 應用程式輸出文件的列印選項。
我可以在 IronPDF Viewer 中載入來自不同來源的 PDF 檔案嗎?
是的,IronPDF Viewer 支援從多種來源載入 PDF 檔案,包括直接檔案路徑、位元組陣列及資料流。這種靈活性讓您能在 MAUI 應用程式中,顯示來自本地儲存空間、記憶體或網路來源的 PDF 檔案。
IronPDF Viewer 適合用於 Enterprise 應用程式嗎?
IronPDF Viewer 非常適合用於開發企業應用程式、文件管理系統及教育軟體。它採用與核心 IronPDF 函式庫相同的渲染引擎,確保文件顯示精準,並具備專業級的 PDF 檢視功能,適用於業務關鍵型應用程式。

