1. IronPDF
  2. 教程
  3. 在.NET MAUI中查看PDF文件

Viewing PDFs in MAUI for C# .NET

Curtis Chau
Curtis Chau
更新日期:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 查看器橫幅

在現代跨平台開發的時代，提供用戶能夠直接在您的應用程式中查看 PDF 文件不僅是一種便利，更是一個必需品。 使用 IronPDF Viewer，您可以在 MAUI 應用程式中嵌入 PDF 查看功能。

在本文中，我們將學習如何在 MAUI 應用程式中整合 IronPDF Viewer，讓用戶可以查看、儲存和打印 PDF。

快速入門：在 MAUI 中實現 IronPDF Viewer

只需幾行代碼，即可將 IronPDF Viewer 整合到您的 MAUI 應用程式中。 本快速指南演示如何輕鬆地使用 IronPDF 的強大庫加載 PDF 文件。 此方法專為希望增強其應用以具有無縫 PDF 查看功能的開發人員設計，突顯出使用的方便性和快速實施。 只需初始化 IronPDF Viewer 並加載您的 PDF，以便在您的應用程式中方便地查看 PDF。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小工作流程（5 步）

  1. 下載並安裝 IronPDF Viewer 庫
  2. 將 IronPDF Viewer 整合到 MAUI 應用程式中
  3. 通過添加 XAML 或 C# ContentPage 新增 PDF 查看頁面
  4. 在啟動時通過文件名、字節數組和流加載 PDF
  5. 配置工具欄

下載並安裝 IronPDF Viewer 庫

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步：
green arrow pointer

Visual Studio - NuGet 包管理器

在 Visual Studio 中，在解決方案資源管理器中右鍵單擊您的專案並選擇 管理 NuGet 套件...。 從那裡，您可以搜尋 IronPdf.Viewer.Maui 並安裝最新版本到您的解決方案。 或者，您可以導航到 工具 > NuGet 套件管理器 > 套件管理器控制台 並輸入以下命令以開啟 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.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
$vbLabelText   $csharpLabel

默認情況下，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
$vbLabelText   $csharpLabel

新增 PDF 查看頁面

在本節中，我們將學習如何創建 PDF 查看頁面，整合 IronPDF Viewer，並在 MAUI 應用程式中為其創建一個標籤。 我們將演示如何使用 XAML 和 C# ContentPage 來執行此操作。

步驟

  1. 通過右鍵單擊您的專案並導航至 添加 > 新項目...，向專案中添加一個新頁面 添加新項目

  2. 導航到 .NET MAUI 部分。 要創建 XAML 頁面，請選擇 .NET MAUI ContentPage (XAML)。 對於 C# 文件，請選擇 .NET MAUI ContentPage (C#)。 將文件命名為 PdfViewerPage，然後單擊 添加。 .NET MAUI `ContentPage`

  3. 在 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>
XML

如果您創建的是 C# ContentPage，請改為添加以下代碼並保存：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.cs
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
$vbLabelText   $csharpLabel
  1. 在您的 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>
XML
  1. 保存您的專案，然後構建並運行。 您應該會看到頂部左角有標籤，如下所示，單擊 "PDF Viewer" 標籤應打開 IronPDF 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>
XML

或者，您可以通過使用 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")
$vbLabelText   $csharpLabel

通過字節數組加載

某些用例中，可能需要加載 PDF 的字節數組。 這無法從 XAML 實現，但可以在 C# 中實現。 您可以通過簡單地使用 IronPdfViewSource.FromBytes 方法來實現。 以下是如何使用此方法的示例：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))
$vbLabelText   $csharpLabel

通過流加載

同樣，在某些用例中，將 PDF 通過流加載可能更可取。 這無法從 XAML 實現，但可以在 C# 中實現。 您可以通過簡單地使用 IronPdfViewSource.FromStream 方法來實現。 以下是如何使用此方法的示例：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))
$vbLabelText   $csharpLabel

配置工具欄

使用 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>
XML

或者，您可以在 C# 中實現相同的效果：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
$vbLabelText   $csharpLabel

這將顯示以下內容：

所有工具欄

如果不想顯示任何內容，請將選項設置為 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"/>
XML

同樣，在 C# 中：

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;
pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open
$vbLabelText   $csharpLabel

這將顯示以下內容：

帶有縮略圖和打開文件選項的工具欄

結論

在本教程中，我們學習了如何在 MAUI 應用程式中整合 IronPDF Viewer 並如何自訂其工具欄以最符合您的需求。

此查看器隨著我們的 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 相關的任何協助或功能請求。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 16,154,058 | 版本： 2025.11 剛剛發布