在 MAUI for C# .NET 中查看 PDF
在當今跨平台開發的時代，讓使用者能夠直接在應用程式內查看 PDF 文件不僅是一種便利，更是一種必需。 使用IronPDF Viewer ，您可以將 PDF 檢視功能嵌入到您的 MAUI 應用程式中。
在本文中，我們將學習如何將IronPDF Viewer整合到 MAUI 應用程式中，以便使用者能夠檢視、儲存和列印 PDF 文件。
快速入門：在 MAUI 中實作 IronPDF 檢視器
只需幾行程式碼，即可開始將 IronPDF Viewer 整合到您的 MAUI 應用程式中。 本快速指南示範如何使用 IronPDF 的強大庫輕鬆載入 PDF 文件。 對於渴望透過無縫 PDF 查看功能來增強應用程式的開發人員來說，這種方法非常理想，它突出了易用性和快速實施的特點。 只需初始化 IronPDF Viewer 並加載您的 PDF 文件，即可在您的應用程式中輕鬆查看 PDF 文件。
立即開始使用 NuGet 建立 PDF 檔案：
使用 NuGet 套件管理器安裝 IronPDF
複製並運行這段程式碼。
var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };部署到您的生產環境進行測試
最小工作流程（5 個步驟）
- 下載並安裝 IronPDF Viewer 庫
- 将IronPDF Viewer集成到MAUI应用程序中
- 透過新增 XAML 或 C# 內容頁面來新增 PDF 檢視器頁面。
- 啟動時透過檔案名稱、位元組數組和流載入 PDF 檔案。
- 配置工具栏
下載並安裝 IronPDF 檢視器庫
!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101
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.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");IRON VB CONVERTER ERROR developers@ironsoftware.com新增 PDF 檢視器頁面
在本節中，我們將學習如何建立 PDF 檢視器頁面、整合 IronPDF 檢視器，並在 MAUI 應用程式中為其建立一個標籤。 我們將示範如何使用 XAML 和 C# ContentPage來實現這一點。
步驟
右鍵點選項目，然後選擇
Add > New Item...即可新增頁面新增頁面到項目。 新增項目導航至
.NET MAUI部分。 若要建立 XAML 頁面，請選擇.NET MAUI ContentPage (XAML)。 對於 C# 文件，請選擇.NET MAUI ContentPage (C#)。 將檔案命名為 PdfViewerPage，然後按一下Add。 ! .NET MAUIContentPage- 在 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 檢視器"標籤即可開啟 IronPDF 檢視器。
啟動時載入 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>或者，您也可以在 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")透過位元組數組加載
在某些情況下，可能需要載入 PDF 的位元組數組。 這在 XAML 中無法實現，但在 C# 中可以實現。 您只需使用IronPdfViewSource.FromBytes方法即可實現此目的。 下面展示如何使用這種方法：
: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"))透過串流加載
同樣地，在某些使用場景下，透過串流載入 PDF 檔案可能更為理想。 這在 XAML 中無法實現，但在 C# 中可以實現。 您只需使用IronPdfViewSource.FromStream方法即可實現此目的。 下面展示如何使用這種方法：
: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"))配置工具列
使用 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>或者，您也可以用 C# 實現相同的功能：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cspdfView.Options = IronPdfViewOptions.All;pdfView.Options = IronPdfViewOptions.All將顯示以下內容：
如果您不想顯示任何內容，請將選項設為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"/>同樣地，在 C# 中：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open結論
在本教學中，我們學習如何將 IronPDF Viewer 整合到 MAUI 應用程式中，以及如何自訂其工具列以更好地滿足您的需求。
此檢視器隨我們的 IronPDF 產品一起提供。 如果您想提出功能請求或對 IronPDF Viewer（或 IronPDF）有任何一般性問題，請聯絡我們的支援團隊。 我們非常樂意為您提供協助。
常見問題解答
如何在 MAUI 應用程式中使用 C# 查看 PDF？
要在 MAUI 應用程式中使用 C# 查看 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 文件？
您可以在啟動時使用 IronPDF Viewer 方法，例如 IronPdfViewSource.FromFile、FromBytes 或 FromStream 在 MAUI 應用中載入 PDF 文件。
IronPDF Viewer 的工具欄配置選項有哪些？
IronPDF Viewer 的工具欄可以自定義為包含縮圖檢視、文本搜尋、頁面導航、縮放、旋轉和文件操作等選項。您可以根據需要設置顯示全部選項、無選項或僅顯示特定工具。
如何自定義 PDF 查看器的工具欄以顯示特定工具？
要自定義工具欄以顯示特定工具，請在 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 檢視功能，而無需使用變通工具。
免費開始
免費開始
預訂免費直播演示
無需信用卡或建立帳號
