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 文件。
-
1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
-
2Copy and run this code snippet.
var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };C# -
3Deploy to test on your live environment
Start using IronPDF in your project today with a free trial
簡化工作流程（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 套件管理員控制台：
PM > Install-Package IronPdf.Viewer.Maui
將 IronPDF Viewer 整合至 MAUI 應用程式
在接下來的章節中，我們將示範如何將 IronPDF Viewer 整合至預設的 MAUI 應用程式中。
設定
在將 IronPDF Viewer 加入您的 MAUI 專案之前，請確認該專案未針對 iOS 和 Android 平台進行開發。 您可以透過右鍵點擊專案檔案並選擇"**內容"**來確認此設定。 若"針對 iOS 平台"和"針對 Android 平台"核取方塊尚未取消勾選，請將其取消勾選。 若要成功實施此變更，您可能需要先取消勾選選項並重新啟動 Visual Studio，然後再儲存專案。
取消針對 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();
}
}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：
.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"
...>
<ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>若您原本撰寫的是 C# ContentPage，請改為加入以下程式碼並儲存：
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- 在您的 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>- 儲存您的專案，然後進行編譯並執行。 您應會看到如下圖所示位於左上角的標籤頁，點擊
"PDF Viewer"標籤頁應會開啟 IronPDF Viewer。
啟動時載入 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>IronPdfViewSource.FromFile
此外，您亦可透過在 C# 程式碼中使用 LoadFromFilename() 方法，根據檔案名稱載入 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")IronPdfViewSource.FromBytes
透過位元組陣列載入
在某些使用情境下，可能需要載入 PDF 的位元組陣列。 這在 XAML 中無法實現，但在 C# 中則可以。 您只需使用 LoadFromByteArray() 方法即可達成此目標。 以下為此方法的使用範例：
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))IronPdfViewSource.FromStream
透過流載入
同樣地，在某些使用情境下，透過串流載入 PDF 檔案可能更為理想。 這在 XAML 中無法實現，但在 C# 中則可以。 您只需使用 LoadFromStream() 方法即可達成此目標。 以下為此方法的使用範例：
pdfView.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：
<?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# 實現相同的功能：
pdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.AllAll
這將顯示以下內容：
若不想顯示任何內容，請將選項設定為 None。 若將 ToolbarOptions 設定為以下內容，工具列將不會顯示：
您可以選擇要顯示哪些特定選項。 例如，若您只想顯示縮圖和開啟檔案選項，請在 XAML 中將 PdfViewerControl 的 ToolbarOptions 參數修改如下：
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>None
同樣地，在 C# 中：
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.OpenOptions
結論
在本教學中，我們學習了如何將 IronPDF Viewer 整合至 MAUI 應用程式，以及如何自訂其工具列以最佳化使用體驗。
此檢視器隨附於我們的 IronPDF 產品中。 若您想提出功能需求，或對 IronPDF Viewer（或 IronPDF）有任何一般性疑問，請聯絡我們的支援團隊。 我們非常樂意為您提供協助。
Options
IronPdfView
Frequently Asked Questions
如何在MAUI應用程式中使用C#檢視PDF？
要在MAUI應用程式中使用C#檢視PDF，您可以整合IronPDF Viewer程式庫。這涉及在Visual Studio中通過NuGet安裝該程式庫並在您的專案中配置它以啟用PDF檢視功能。
在MAUI應用中整合PDF Viewer的過程是什麼？
在MAUI應用中整合PDF Viewer需要使用NuGet套件管理器安裝IronPDF Viewer程式庫，並使用MauiProgram.cs和XAML或C# ContentPage在您的專案中設置檢視器以顯示PDF。
IronPDF Viewer可以在MAUI專案中的iOS和Android平台上使用嗎？
目前，IronPDF Viewer是為不以iOS和Android平台為目標的MAUI專案設計的。它最適合用於以桌面環境為目標的專案。
如何在我的MAUI專案啟動時載入PDF文件？
您可以在啟動時透過IronPDF Viewer方法如IronPdfViewSource.FromFile、FromBytes或FromStream在您的MAUI應用程式中載入PDF文件。
IronPDF Viewer的工具欄配置選項是什麼？
IronPDF Viewer的工具欄可以自訂以包含縮圖檢視、文字搜尋、頁面導航、縮放、旋轉和文件操作等選項。您可以根據需求設置為顯示所有選項、不顯示或僅顯示特定工具。
如何自訂PDF Viewer工具欄以顯示特定工具？
要自訂工具欄以顯示特定工具，調整您的XAML或C#程式碼中的'Options'參數，以僅包含所需的選項，例如'ThumbnailView,OpenFile'。
可以在IronPDF Viewer中隱藏工具欄嗎？
是的，您可以通過將'Options'參數設置為'None'來隱藏工具欄，這將從檢視器介面除去工具欄。
如何處理MAUI應用程式中的PDF渲染問題？
如果您在MAUI應用程式中遇到PDF渲染問題，請確保IronPDF程式庫已正確安裝和配置。此外，檢查是否存在任何平台特定的限制或向IronPDF的技術團隊尋求支援。
在哪裡可以找到在MAUI應用中整合IronPDF Viewer的支援？
您可以通過IronPDF的官方網站聯繫技術支援團隊，尋求任何與在MAUI應用中整合IronPDF Viewer有關的協助或功能請求。
IronPDF Viewer 與 .NET 10 專案完全相容嗎？
是的。IronPDF支援.NET 10的所有主要產品線，包括用於MAUI應用的Viewer組件。IronPDF Viewer套件與目標框架如net10.0-windows和net10.0-maccatalyst相容，使開發者能夠在.NET 10桌面為基礎的專案中嵌入PDF檢視功能，無需替代方案。
Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.
