Viewing PDFs in MAUI for C# .NET
在當今跨平台開發的時代，讓使用者能夠直接在應用程式內檢視 PDF 文件，不僅是種便利，更是必要之舉。 透過 IronPDF Viewer，您可以將 PDF 檢視功能嵌入您的 MAUI 應用程式中。
在本文中，我們將學習如何將 IronPDF Viewer 整合至 MAUI 應用程式中，讓使用者能夠檢視、儲存及列印 PDF 檔案。
快速入門：在 MAUI 中實作 IronPDF Viewer
只需幾行程式碼，即可開始將 IronPDF Viewer 整合至您的 MAUI 應用程式中。 本快速指南將示範如何利用 IronPDF 的強大函式庫，輕鬆載入 PDF 檔案。 此方案非常適合希望為應用程式增添無縫 PDF 檢視功能的開發者，其重點在於操作簡易與快速實作。 只需初始化 IronPDF Viewer 並載入您的 PDF 檔案，即可在應用程式中輕鬆瀏覽 PDF 文件。
簡化工作流程（5 個步驟）
- 下載並安裝 IronPDF Viewer 函式庫
- 將 IronPDF Viewer 整合至 MAUI 應用程式
- 透過新增 XAML 或 C# ContentPage 來建立 PDF 檢視頁面
- 在啟動時透過檔案名稱、位元組陣列及串流載入 PDF
- 設定工具列
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，然後再儲存專案。
<img src="/static-assets/pdf/tutorials/pdf-viewing/properties_screen_underlined.png" alt=""屬性"畫面">
取消針對 iOS 和 Android 平台的設定後，請前往 MauiProgram.cs 檔案，並加入以下程式碼以初始化檢視器：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.csusing 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 檔案中加入以下程式碼並儲存：
: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>若您原本撰寫的是 C# ContentPage，請改為加入以下程式碼並儲存：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.csusing 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- 在您的 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>- 儲存您的專案，然後進行編譯並執行。 您應會看到如下圖所示位於左上角的標籤頁，點擊
"PDF Viewer"標籤頁應會開啟 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>IronPdfViewSource.FromFile
此外，您亦可透過在 C# 程式碼中使用 LoadFromFilename() 方法，根據檔案名稱載入 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")IronPdfViewSource.FromBytes
透過位元組陣列載入
在某些使用情境下，可能需要載入 PDF 的位元組陣列。 這在 XAML 中無法實現，但在 C# 中則可以。 您只需使用 LoadFromByteArray() 方法即可達成此目標。 以下為此方法的使用範例：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cspdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))IronPdfViewSource.FromStream
透過流載入
同樣地，在某些使用情境下，透過串流載入 PDF 檔案可能更為理想。 這在 XAML 中無法實現，但在 C# 中則可以。 您只需使用 LoadFromStream() 方法即可達成此目標。 以下為此方法的使用範例：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cspdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))Option
設定工具列
透過 IronPDF Viewer，您可以選擇要在工具列中顯示哪些選項。 可選方案如下：
- 縮圖檢視
- 檔案名稱顯示
- 文字搜尋
- 頁碼導覽
- Zoom
- 調整為寬度
- 調整為高度
- 順時針旋轉
- 逆時針旋轉
- 開啟檔案
- 下載檔案
- 列印檔案
- 顯示註解
- 兩頁檢視
預設情況下，IronPDF Viewer 會顯示如下所示的工具列：
在預設檢視中，檔案名稱顯示、文字搜尋以及逆時針旋轉選項均已停用。 若要顯示所有內容，請將 XAML 中 PdfViewerControl 標籤的 ToolbarOptions 參數設定為 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>IronPdfView
或者，您也可以使用 C# 實現相同的功能：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cspdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.AllAll
這將顯示以下內容：
若不想顯示任何內容，請將選項設定為 None。 若將 ToolbarOptions 設定為以下內容，工具列將不會顯示：
您可以選擇要顯示哪些特定選項。 例如，若您只想顯示縮圖和開啟檔案選項，請在 XAML 中將 PdfViewerControl 的 ToolbarOptions 參數修改如下：
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-5.xml<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>None
同樣地，在 C# 中：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.OpenOptions
結論
在本教學中，我們學習了如何將 IronPDF Viewer 整合至 MAUI 應用程式，以及如何自訂其工具列以最佳化使用體驗。
此檢視器隨附於我們的 IronPDF 產品中。 若您想提出功能需求，或對 IronPDF Viewer（或 IronPDF）有任何一般性疑問，請聯絡我們的支援團隊。 我們非常樂意為您提供協助。
Options
IronPdfView
常見問題
如何在 MAUI 應用程式中使用 C# 檢視 PDF 檔案？
若要在 C# 的 MAUI 應用程式中檢視 PDF 檔案，您可以整合 IronPDF Viewer 函式庫。這需要透過 Visual Studio 的 NuGet 安裝該函式庫，並在專案中進行設定以啟用 PDF 檢視功能。
在 MAUI 應用程式中整合 PDF 檢視器的流程為何？
要在 MAUI 應用程式中整合 PDF 檢視器，需透過 NuGet 套件管理員安裝 IronPDF Viewer 函式庫，並透過 MauiProgram.cs 以及 XAML 或 C# ContentPage 在專案中設定檢視器，以顯示 PDF 檔案。
IronPdf Viewer 能否在 MAUI 專案中於 iOS 和 Android 平台上使用？
目前，IronPDF Viewer 專為不針對 iOS 和 Android 平台的 MAUI 專案設計。其最適合用於針對桌面環境的專案。
如何在我的 MAUI 專案中於應用程式啟動時載入 PDF 檔案？
您可以在 MAUI 應用程式中，透過 IronPDF Viewer 的方法（例如 IronPdfViewSource.FromFile、FromBytes 或 FromStream）在啟動時載入 PDF 檔案。
IronPDF Viewer 的工具列設定選項有哪些？
IronPDF Viewer 工具列可自訂，包含縮圖檢視、文字搜尋、頁面導覽、Zoom、旋轉及檔案操作等選項。您可以根據需求，將其設定為顯示所有選項、不顯示任何選項，或僅顯示特定工具。
如何自訂 PDF 檢視器工具列以顯示特定工具？
若要自訂工具列以顯示特定工具，請在 XAML 或 C# 程式碼中調整「Options」參數，僅包含所需的選項，例如「ThumbnailView,OpenFile」。
是否可以在 IronPDF Viewer 中隱藏工具列？
是的，您可以透過將 'Options' 參數設定為 'None' 來隱藏工具列，此設定將從檢視器介面中移除工具列。
如何解決 MAUI 應用程式中的 PDF 渲染問題？
若在 MAUI 應用程式中遇到 PDF 渲染問題，請確認 IronPDF 函式庫已正確安裝並設定。此外，請檢查是否有任何平台特定的限制，或向 IronPDF 的技術團隊尋求支援。
哪裡可以找到關於在 MAUI 應用程式中整合 IronPDF Viewer 的支援資訊？
若您需要任何協助或有將 IronPDF Viewer 整合至 MAUI 應用程式的功能需求，可透過 IronPDF 官方網站聯繫其支援團隊。
IronPDF Viewer 是否與 .NET 10 專案完全相容？
是的。IronPDF 旗下所有主要產品線均支援 .NET 10，包括適用於 MAUI 應用程式的 Viewer 元件。IronPDF Viewer 套件相容於 net10.0-windows 和 net10.0-maccatalyst 等目標框架，讓開發人員無需使用變通方案，即可在基於 .NET 10 的桌面專案中嵌入 PDF 檢視功能。
還在往下捲動嗎？
想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。
立即免費開始
立即免費開始
預約免費線上示範
無需信用卡或註冊帳號
