在 MAUI 中檢視 PDF 文件,適用於 C# .NET
使用 IronPDF Viewer 直接在您的 MAUI 應用程式中檢視 PDF,它提供了一個功能完整的 PDF 檢視元件,僅需一行程式碼即可提供導覽、縮放、搜尋和列印的工具列選項。

跨平台應用程式常需直接在應用程式內顯示PDF文件。IronPDF Viewer讓您可以將PDF檢視功能嵌入至您的MAUI應用程式,實現Windows和macOS平台上的文件檢視。
IronPDF Viewer 是由 IronPDF程式庫 背後團隊提供的免費元件。 它以一個獨立的包安裝,并提供與 .NET MAUI 應用程序的原生集成,應用 IronPDF 或 Iron Suite 授權密鑰可以移除其默認顯示的品牌橫幅。
本文展示了如何在 MAUI 應用程式中整合 IronPDF Viewer,以允許使用者檢視、儲存及列印 PDF。 以下部分介紹了安裝包、將查看器添加到頁面、啓動時加載文檔以及配置工具欄以适應您的應用程序。
快速入門:使用IronPDF在MAUI中查看PDF將 IronPDF 整合至您的 MAUI 應用程式,並立即開始檢視 PDF。 此代碼片段演示了如何實例化 IronPdfView 控件并加載 PDF 文件以供查看。 視圖的 Source 是一個 IronPdfViewSource,您可以通過其一個靜態工廠方法構建它:
-
1使用 IronPDF 安裝 NuGet Package Manager
-
2複製並運行這段程式碼。
new IronPdf.Viewer.Maui.IronPdfView { Source = IronPdf.Viewer.Maui.IronPdfViewSource.FromFile("document.pdf") };New IronPdf.Viewer.Maui.IronPdfView With { .Source = IronPdf.Viewer.Maui.IronPdfViewSource.FromFile("document.pdf") }New IronPdf.Viewer.Maui.IronPdfView With { .Source = IronPdf.Viewer.Maui.IronPdfViewSource.FromFile("document.pdf") } -
3部署到您的生產環境進行測試
立即在您的項目中開始使用 IronPDF,並使用 免費試用
最小工作流程(5 個步驟)
- 下載並安裝IronPDF Viewer程式庫
- 將IronPDF Viewer集成到MAUI應用程式中
- 通過添加 XAML 或 C#
ContentPage來添加 PDF 檢視器頁面 - 啟動時透過檔案名稱、位元組數組和流載入 PDF 檔案。
- 配置工具欄
如何下載和安裝IronPDF Viewer程式庫?
如何通過NuGet Package Manager安裝?
在 Visual Studio 中,右鍵單擊解決方案資源管理器中的項目并選擇 Manage NuGet Packages...。 從那里,搜索 IronPdf.Viewer.Maui 并安裝最新版本到您的解決方案中。 欲了解更詳細的安裝指南,請參閱我們的安裝概覽。 或者,通過導航到 Tools > NuGet Package Manager > Package Manager Console 并輸入以下命令,打開 NuGet 包管理器控制台:
IronPDF Viewer 包是自包含的,包含在 MAUI 應用程序中顯示 PDF 所需的一切內容。 它攜帶自己的渲染引擎,并不依賴於核心 IronPdf 包,因此您可以將其添加到不使用 IronPDF 的項目中。
該包提供 net7.0-windows10.0.19041 和 net7.0-maccatalyst16.1 程序集,這使得 .NET 7 是最低要求而不是限制。 以較高版本 .NET 為目標的 MAUI 項目根據 NuGet 的框架兼容性規則解決相同的程序集,并且此頁面上的步驟已經在 Windows 上針對 .NET 9 和 .NET 10 MAUI 應用程序進行了驗證。 如果您正在使用 .NET 10,請參閱 按文件名加載 下的備注,獲取您需要的一個構建設置。 還值得注意的是,IronPdf.Viewer.Maui 具有自己的版本號,與核心 IronPdf 包分開,所以当您瀏覽 NuGet 時,兩者將不匹配。
如何將IronPDF Viewer整合到MAUI應用程式中?
以下部分展示了如何將 IronPDF Viewer 集成到默認的 MAUI 應用程序中,從不作為目標的移動平台到啓動時初始化查看器。
在整合之前需要做哪些設定?
在將 IronPDF Viewer 加入您的 MAUI 專案之前,請確認其並非針對 iOS 和 Android 平台。 目前,IronPDF Viewer 支援 Windows 和 macOS 桌面平台。
右鍵單擊項目并選擇 Properties,然后打開 Application → General。 向下滾動到 iOS Targets 和 Android Targets 部分,并清除下面下划的兩個复選框,Enable targeting of the iOS platform. 和 Enable targeting of the Android platform. 然后保存項目。 您可能需要重新加載它以使更改生效。

直接編輯項目文件可以執行相同的操作,并且驗證速度更快。 將生成的 TargetFrameworks 行替換為您要構建的單個平台:
<TargetFrameworks>net10.0-windows10.0.19041.0</TargetFrameworks>
在不作為目標 iOS 和 Android 平台后,轉到您的 MauiProgram.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();
}
}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 ModuleImports 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)授權密鑰添加到 ConfigureIronPdfView:
.ConfigureIronPdfView("YOUR-LICENSE-KEY");.ConfigureIronPdfView("YOUR-LICENSE-KEY");.ConfigureIronPdfView("YOUR-LICENSE-KEY").ConfigureIronPdfView("YOUR-LICENSE-KEY")欲了解如何獲得和應用授權金鑰的詳細資訊,請參考我們的授權金鑰指南。
如何新增PDF查看頁面?
本節涵蓋如何在 MAUI 應用程式中建立 PDF Viewer 頁面、整合 IronPDF Viewer 並為其建立標籤。 我們展示了同時使用 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"
...>
<ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>
如果您創建的是 C# ContentPage,請添加以下代碼并保存。 代碼級頁面沒有后面的 XAML,因此沒有生成的 InitializeComponent 可以調用。 構建視圖并直接將其分配給 Content:
using IronPdf.Viewer.Maui;
public class PdfViewerPage : ContentPage
{
private readonly IronPdfView pdfView;
public PdfViewerPage()
{
this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };
Content = this.pdfView;
}
}
-
在您的
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 -
儲存項目,然後建置並執行。 您應該可以在左上角看到標籤,如下所示。 按一下「PDF 檢視器」標籤可開啟 IronPDF 檢視器。 檢視器提供功能豐富的 PDF 文件互動介面。

如何在啟動時載入PDF?
在應用程式啟動時,IronPDF Viewer 預設會提示使用者開啟 PDF。 不過,它可以在啟動時自動打開 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>
在 .NET 10 上,從 XAML 設置 Source 需要一個項目設置。 .NET 10 MAUI 項目模板通過在 .csproj 中添加 <MauiXamlInflator>SourceGen</MauiXamlInflator> 將 XAML 編譯改為源生成器,并且生成的代碼無法訪問將 Source 字符串轉換為 IronPdfViewSource 的內部類型轉換器。 構建失敗,并顯示以下內容:
error CS0122: 'be' is inaccessible due to its protection level
在您的 .csproj 中將該頁面排除在源生成器之外:
<ItemGroup>
<MauiXaml Update="PdfViewerPage.xaml" Inflator="Runtime" />
</ItemGroup>
設置 <MauiXamlInflator>Runtime</MauiXamlInflator> 用於整個項目也可以,刪除模板添加的屬性也可以。 只有 Source 受到影響。 Options 在源生成器下干淨地編譯,而從 C# 分配 Source 則完全繞過了這個問題。 未設置 MauiXamlInflator 的項目,包括在 .NET 9 或更早版本上運行的項目,不需要更改。
設置 Source 后,查看器跳過文件提示,并在頁面打開時立即渲染文檔:

或者,使用 C# ContentPage 中的 IronPdfViewSource.FromFile 方法以編程方式通過文件名加載 PDF。 此方法可為動態檔案載入提供更大的靈活性:
// 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");' 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 中是不可能的,但您可以通過 C# 使用 IronPdfViewSource.FromBytes 方法來實現這一點:
string file = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), "Downloads", "example.pdf");
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes(file));
此方法在與文件管理系統整合或透過IronPDF的HTML到PDF功能動態生成PDF時很有用。
如何透過資料流載入?
對於以流形式到達應用程序的 PDF,例如網絡響應或數據庫閱讀器,請在 C# 中使用 IronPdfViewSource.FromStream 方法:
string file = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), "Downloads", "example.pdf");
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead(file));
這樣可以使加載代碼靠近已經生成流的代碼,而不是首先將文檔寫入磁盤。
如何配置工具欄?
使用 IronPDF Viewer,您可以選擇顯示在工具欄中的哪些控件,因此界面僅顯示用戶所需的功能。 在 IronPdfView 上設置 Options 屬性為以下旗標的任意組合:
IronPdfViewOptions 標志 | 工具欄控件 |
|---|---|
Thumbs | 縮略圖面板切換 |
FileName | 文件名顯示 |
Search | 文本搜索 |
Navigation | 頁碼和頁面前后 |
Zoom | 縮小、縮放級别、放大 |
FitWidth | 适合寬度 |
FitHeight | 适合買高 |
RotateCw | 順時針旋轉 |
RotateCcw | 逆時針旋轉 |
Open | 打開文件 |
Save | 下載文件 |
Print | 打印文件 |
More | 溢出(⋮)菜單 |
還定義了兩個复合值:All,打開上面的每個標志,以及 Default,這是您未設置 Options 時獲得的結果。
預設情況下,IronPDF Viewer 會顯示下圖所示的工具列:

默認省略了四個控件:文件名顯示、文本搜索、逆時針旋轉和下載文件。要顯示所有內容,請將 XAML 中 IronPdfView 標記的 Options 參數設置為 All:
<?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>
或者,用 C# 達成同樣的目的:
pdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.AllpdfView.Options = IronPdfViewOptions.All這樣將顯示完整的工具欄,添加文件名、搜索圖標、逆時針旋轉和下載按鈕:

要完全隱藏工具欄,請將選項設置為 None:
<ipv:IronPdfView x:Name="pdfView" Options="None"/>
然后文檔填充整個視圖,頂部沒有任何外邊框,适合於展示屏或只讀屏幕:

您可以選擇要顯示的特定選項。 例如,要僅顯示縮略圖和打開文件選項,請修改 XAML 中 IronPdfView 的 Options 參數:
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
同樣地,在 C# 中:
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.OpenpdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open此顯示:
![]()
這種程度的控制可以讓您根據應用程序自定義查看器。 例如,您可以移除安全文件查看器中的下載選項,或者在一個簡單的只讀屏幕上精簡界面。
我可以下載完成的項目嗎?
一個完整的、可運行的上面覆蓋的版本可用作 下載 MAUI 示例項目(285 KB)。 它針對在 Windows 上的 .NET 10 進行目標化,引用 IronPdf.Viewer.Maui,并包括 MauiProgram.cs 注冊、查看器頁面、選項卡 AppShell 以及一個要打開的示例 PDF。
解壓縮它,然后從包含解決方案的文件夾中構建:
dotnet build -f net10.0-windows10.0.19041.0
dotnet run --project IronPdfViewerMauiSample -f net10.0-windows10.0.19041.0
您還可以在 Visual Studio 中打開 IronPdfViewerMauiSample.slnx 并按 F5。当應用啓動時,單擊 PDF Viewer 選項卡,選擇 Browse file,并選擇包含的 sample.pdf 親自測試一下。 構建它需要 .NET MAUI 工作負載,您可以通過簡稱dotnet workload install maui安裝。
結論
本教程介紹了安裝 IronPDF Viewer、將其添加到 XAML 或 C# 中的 MAUI 頁、通過文件名、字節數組或流加載 PDF 以及配置顯示在工具欄中的控件。 通過這兩種方法,您可以將查看器适配到您的項目已經使用的任何結構中。
該查看器坐落在 IronPDF 本身旁邊,后者處理 PDF 生成 、 編輯 和 操作 。 如果您希望提出功能請求或對IronPDF Viewer(或IronPDF)有任何一般性問題,請聯繫我們的支援團隊。 我們很樂意為您提供協助。
對於更高級的 PDF 操作,請參閱 光柵化 PDF 到圖像或了解應用授權密鑰以供 IronPDF 生產使用。
常見問題
IronPDF Viewer在.NET MAUI應用程式中是用來做什麼的?
IronPDF Viewer用於將全功能的PDF檢視能力整合到.NET MAUI應用程式中,提供導航、縮放、搜尋和列印等功能。
我如何安裝IronPDF Viewer程式庫?
您可以透過在Visual Studio中使用NuGet套件管理器搜尋'IronPdf.Viewer.Maui',並安裝最新版本到您的解決方案中來安裝IronPDF Viewer程式庫。
IronPDF Viewer是否支援iOS和Android平台?
不,IronPDF Viewer目前支援Windows和macOS桌面平台,不支援iOS和Android。
我該如何在MAUI應用程式中整合IronPDF Viewer?
要整合IronPDF Viewer,您應確保專案目標為Windows和macOS,於'MauiProgram.cs'檔案中新增檢視器設定,並使用'ConfigureIronPdfView'方法初始化檢視器。
IronPDF Viewer中的工具欄配置有哪些選項?
在IronPDF Viewer中,工具欄可配置顯示縮圖檢視、檔名顯示、文本搜尋、導航、縮放、旋轉、檔案開啟、下載及列印控制項。
我可以在應用程式啟動時自動載入PDF到IronPDF Viewer嗎?
能,IronPDF Viewer允許您透過指定像是'FromFile'、'FromBytes'或'FromStream'的方法的檔案來源,自動在啟動時載入PDF文件。
我該如何使用IronPDF在MAUI應用程式中創建一個PDF檢視頁面?
要創建PDF檢視頁面,請在專案中新增一個.NET MAUI ContentPage,整合IronPDF Viewer,並在'AppShell.xaml'檔案中包含導航標籤。
在企業應用程式中使用IronPDF Viewer有哪些好處?
IronPDF Viewer提供流暢而功能豐富的PDF檢視體驗,非常適合需要可靠文件顯示的企業應用程式,如文件管理系統或教育軟體。
我如何使用位元組陣列在IronPDF Viewer中管理PDF載入?
您可以使用'IronPdfViewSource.FromBytes'方法從位元組陣列載入PDF,這在處理來自資料庫或網路服務的PDF時特別有用。
我應該怎樣更改或應用IronPDF Viewer的授權金鑰?
要套用授權金鑰,請在 'ConfigureIronPdfView' 方法中加入該金鑰。請參閱 'License Keys guide' 獲取和應用授權金鑰。金鑰可以移除檢視器的品牌橫幅。
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。