在 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 檔案。
- 配置工具列
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();
}
}預設情況下，IronPDF Viewer 會在視圖的右下角顯示一個橫幅。 若要移除此視圖，請依下列方式將您的 IronPDF（或 Iron Suite）授權金鑰新增至ConfigureIronPdfViewer ：
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs.ConfigureIronPdfView("YOUR-LICENSE-KEY");新增 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;
}
}
- 在您的 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");透過位元組數組加載
在某些情況下，可能需要載入 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"));透過串流加載
同樣地，在某些使用場景下，透過串流載入 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"));配置工具列
使用 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;將顯示以下內容：
如果您不想顯示任何內容，請將選項設為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;結論
在本教學中，我們學習如何將 IronPDF Viewer 整合到 MAUI 應用程式中，以及如何自訂其工具列以更好地滿足您的需求。
此檢視器隨我們的 IronPDF 產品一起提供。 如果您想提出功能請求或對 IronPDF Viewer（或 IronPDF）有任何一般性問題，請聯絡我們的支援團隊。 我們非常樂意為您提供協助。
常見問題解答
如何使用 C# 在 MAUI 應用程式中查看 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 檔案？
您可以在 MAUI 應用程式中使用 IronPDF Viewer 方法（例如IronPdfViewSource.FromFile 、 FromBytes或FromStream在啟動時載入 PDF 檔案。
IronPDF Viewer的工具列配置選項有哪些？
IronPDF Viewer 工具列可以自訂，包含縮圖視圖、文字搜尋、頁面導航、縮放、旋轉和檔案操作等選項。您可以根據需要設定顯示所有選項、不顯示任何選項或僅顯示特定工具。
如何自訂 PDF 檢視器工具列以顯示特定工具？
若要自訂工具列以顯示特定工具，請在 XAML 或 C# 程式碼中調整「Options」參數，使其僅包含所需的選項，例如「ThumbnailView,OpenFile」。
是否可以在 IronPDF Viewer 中隱藏工具列？
是的，您可以透過將「選項」參數設為「無」來隱藏工具列，這將從檢視器介面中移除工具列。
如何解決 MAUI 應用程式中的 PDF 渲染問題？
如果在使用 MAUI 應用程式時遇到 PDF 渲染問題，請確保 IronPDF 庫已正確安裝和配置。此外，請檢查是否有任何平台特定的限制，或聯絡 IronPDF 的技術團隊尋求支援。
在哪裡可以找到將 IronPDF Viewer 整合到 MAUI 應用程式中的支援資訊？
如需有關在 MAUI 應用程式中整合 IronPDF Viewer 的任何協助或功能請求，您可以透過 IronPDF 的官方網站聯絡其支援團隊。
IronPDF Viewer 是否完全相容於 .NET 10 項目？
是的。 IronPDF 的所有主要產品線均支援 .NET 10，包括 MAUI 應用的 Viewer 元件。 IronPDF Viewer 套件相容於 net10.0-windows 和 net10.0-maccatalyst 等目標框架，可讓開發人員將 PDF 檢視功能嵌入到基於 .NET 10 的桌面專案中，而無需任何變通方案。
立即免費開始
立即免費開始
免費線上示範
無需信用卡或建立帳戶
