Viewing PDFs in MAUI for C# .NET

Q: 在MAUI應用中整合PDF Viewer的過程是什麼？

在MAUI應用中整合PDF Viewer需要使用NuGet套件管理器安裝IronPDF Viewer程式庫，並使用 MauiProgram.cs 和XAML或C# ContentPage在您的專案中設置檢視器以顯示PDF。

Q: 如何在我的MAUI專案啟動時載入PDF文件？

您可以在啟動時透過IronPDF Viewer方法如 IronPdfViewSource.FromFile 、 FromBytes 或 FromStream 在您的MAUI應用程式中載入PDF文件。

Curtis Chau

Updated: 2026年4月24日

IronPDF Viewer 橫幅

在當今跨平台開發的時代，讓使用者能夠直接在應用程式內檢視 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
```
Install-Package IronPdf
```

2複製並運行這段程式碼片段。

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

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

3部署以在您的實時環境中測試

今天就開始在您的專案中使用IronPDF，透過免費試用

簡化工作流程（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

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();
    }
}

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

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");

.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>

<?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，請改為加入以下程式碼並儲存：

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;
    }
}

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

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>

<?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

儲存您的專案，然後進行編譯並執行。您應會看到如下圖所示位於左上角的標籤頁，點擊 "PDF Viewer" 標籤頁應會開啟 IronPDF 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>

<?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

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");

' 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"));

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"));

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))

pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))

Option

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

設定工具列

透過 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>

<?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

IronPdfView

或者，您也可以使用 C# 實現相同的功能：

pdfView.Options = IronPdfViewOptions.All;

pdfView.Options = IronPdfViewOptions.All;

pdfView.Options = IronPdfViewOptions.All

pdfView.Options = IronPdfViewOptions.All

All

這將顯示以下內容：

所有工具列

若不想顯示任何內容，請將選項設定為 None。若將 ToolbarOptions 設定為以下內容，工具列將不會顯示：

無工具列

您可以選擇要顯示哪些特定選項。例如，若您只想顯示縮圖和開啟檔案選項，請在 XAML 中將 PdfViewerControl 的 ToolbarOptions 參數修改如下：

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>

XML

None

同樣地，在 C# 中：

pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;

pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;

pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open

pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open

Options

結論

在本教學中，我們學習了如何將 IronPDF Viewer 整合至 MAUI 應用程式，以及如何自訂其工具列以最佳化使用體驗。

此檢視器隨附於我們的 IronPDF 產品中。若您想提出功能需求，或對 IronPDF Viewer（或 IronPDF）有任何一般性疑問，請聯絡我們的支援團隊。我們非常樂意為您提供協助。

Options

IronPdfView

常見問題

如何在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

立即與工程團隊聊天

技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...

準備開始了嗎？

Nuget Downloads 21,105,021|版本：2026.9剛剛發布

使用NuGet安裝

版本： 2026.9

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

在解決方案資源管理器，右鍵點選參考，管理NuGet包
選擇瀏覽並搜尋"IronPdf"
選擇套件並安裝

下載DLL

版本： 2026.9

或者點擊此處下載Windows安裝程式。

下載並解壓IronPDF到類似~/Libs的位置，位於您的解決方案目錄中
在Visual Studio解決方案資源管理器，右鍵點選參考。選擇瀏覽，"IronPdf.dll"

授權從$999起

開始免費30天試用

Viewing PDFs in MAUI for C# .NET

1Install IronPDF with NuGet Package Manager

2複製並運行這段程式碼片段。

3部署以在您的實時環境中測試

簡化工作流程（5 個步驟）

Visual Studio - NuGet 套件管理員

將 IronPDF Viewer 整合至 MAUI 應用程式

設定

新增 PDF 檢視器頁面

步驟

啟動時載入 PDF

依檔案名稱載入

透過位元組陣列載入

透過流載入

Milan Jovanovic

Brent Matzelle

David Jones

設定工具列

結論

常見問題

如何在MAUI應用程式中使用C#檢視PDF？

在MAUI應用中整合PDF Viewer的過程是什麼？

IronPDF Viewer可以在MAUI專案中的iOS和Android平台上使用嗎？

如何在我的MAUI專案啟動時載入PDF文件？

IronPDF Viewer的工具欄配置選項是什麼？

如何自訂PDF Viewer工具欄以顯示特定工具？

可以在IronPDF Viewer中隱藏工具欄嗎？

如何處理MAUI應用程式中的PDF渲染問題？

在哪裡可以找到在MAUI應用中整合IronPDF Viewer的支援？

IronPDF Viewer 與 .NET 10 專案完全相容嗎？

產品連結