在MAUI中查看C# .NET的PDF
使用 IronPDF Viewer 直接在您的 MAUI 应用程序中查看 PDF,它提供了一个全功能的 PDF 查看组件,只需一行代码即可提供导航、缩放、搜索和打印等工具栏选项。

跨平台应用程序通常需要在应用程序中直接显示 PDF 文档。IronPDF Viewer 可让您在 MAUI 应用程序中嵌入 PDF 查看功能,实现跨 Windows 和 macOS 平台的文档查看。
IronPDF Viewer 是一个基于 IronPDF 库的组件,为 PDF 操作和查看提供了全面的解决方案。 它提供了与 .NET MAUI 应用程序的本地集成,可实现跨平台的一致性能。
本文展示了如何在 MAUI 应用程序中集成 IronPDF Viewer,以允许用户查看、保存和打印 PDF。 无论您是在构建企业应用程序、文档管理系统还是教育软件,本指南都将帮助您实现 PDF 浏览功能。
快速入门:在 MAUI 中使用IronPDF查看 PDF
将 IronPDF 集成到您的 MAUI 应用程序中,立即开始查看 PDF。 此代码片段演示了如何实例化 IronPDF PdfViewer 并加载 PDF 文件以供查看。
最小工作流程(5 个步骤)
- 下载并安装 IronPDF Viewer 库。
- 将 IronPDF 查看器集成到 MAUI 应用程序中
- 通过添加XAML或C#
ContentPage来添加PDF查看器页面 - 通过文件名、字节数组和流在启动时加载 PDF
- 配置工具栏
如何下载和安装 IronPDF Viewer 库?
如何通过 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 应用程序中查看 PDF 所需的所有依赖项。 它使用与 IronPDF 核心库相同的渲染引擎,以实现准确的文档显示。
如何将 IronPDF Viewer 集成到 MAUI 应用程序中?
以下各节将演示如何将 IronPDF Viewer 集成到默认的 MAUI 应用程序中。 集成过程简单明了,只需最低限度的配置。
集成前需要进行哪些设置?
在将 IronPDF Viewer 添加到您的 MAUI 项目之前,请确保它不针对 iOS 和 Android 平台。 目前,IronPDF Viewer 支持 Windows 和 macOS 桌面平台。 请右键单击项目文件并选择 Properties 进行验证。 如果 Target the iOS Platform 和 Target the Android platform 复选框已被勾选,请取消勾选。 要使此更改生效,请在取消选中后保存项目并重新启动 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
默认情况下,IronPDF Viewer 会在视图右下方显示一个横幅。 若要移除此横幅并解锁所有功能,请将您的 IronPDF(或 Iron Suite)许可证密钥添加至 ConfigureIronPdfViewer:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
.ConfigureIronPdfView("YOUR-LICENSE-KEY")
有关获取和应用许可证密钥的详细信息,请参阅我们的许可证密钥指南。
如何添加 PDF 查看器页面?
本节介绍如何在 MAUI 应用程序中创建 PDF 查看器页面、集成 IronPDF Viewer 并为其创建一个选项卡。 我们将通过 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"
...>
<?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" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<?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 文档交互提供了功能丰富的界面。

如何在启动时加载 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"
...>
<?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="Thumbs, Open"/>
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<?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="Thumbs, Open"/>
同样,在 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
此显示:
![]()
这种对工具栏选项的细粒度控制可让您创建符合自己应用程序要求的浏览体验。 例如,您可能会限制在安全文档查看器中下载,或简化基本查看场景的界面。
结论
本教程介绍了如何将 IronPDF Viewer 集成到 MAUI 应用程序中,并根据自己的需要自定义其工具栏。 IronPDF Viewer 提供强大的 PDF 浏览体验,只需最少的代码即可无缝集成到您的 .NET MAUI 应用程序中。
该阅读器可以灵活地从各种来源(文件、字节数组和流)加载 PDF,因此适用于从简单的文档阅读器到复杂的文档管理系统等多种应用。 结合广泛的工具栏自定义选项,您可以创建用户所需的确切查看体验。
该阅读器附带有我们的 IronPDF 产品,其中还包括强大的 PDF生成、编辑和 操作功能。 如果您想提出功能请求或对 IronPDF Viewer(或 IronPDF)有任何一般问题,请联系我们的支持团队。 我们将竭诚为您服务。
有关更高级的 PDF 操作,请浏览我们全面的 PDF 查看指南,或了解 应用许可密钥,以充分释放 IronPDF 在您的应用程序中的潜力。
常见问题解答
什么是 IronPDF Viewer 适用于 .NET MAUI?
IronPDF Viewer 是一款功能齐全的 PDF 查看组件,允许您将 PDF 查看功能直接嵌入到 MAUI 应用程序中。它提供用于导航、缩放、搜索和打印的工具栏选项,只需一行代码即可实现。该查看器以 IronPDF 库为基础,提供全面的 PDF 操作和查看功能。
IronPDF Viewer 在 MAUI 应用程序中支持哪些平台?
IronPDF Viewer 提供与 .NET MAUI 应用程序的本地集成,并支持在 Windows 和 macOS 平台上跨平台查看 PDF,确保在这些操作系统上性能一致。
如何在 MAUI 项目中安装 IronPDF Viewer?
您可以通过 Visual Studio 中的 NuGet 包管理器安装 IronPDF Viewer,方法是搜索 "IronPdf.Viewer.Maui "并安装最新版本。或者,也可以使用软件包管理器控制台,执行命令 "Install-Package IronPdf.Viewer.Maui"。该软件包包含在 MAUI 应用程序中查看 PDF 所需的所有依赖项。
如何在 MAUI 应用程序中快速实现 PDF 查看?
IronPDF Viewer 使您只需一行代码就能嵌入一个全功能的 PDF 查看器:new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };。这样就能非常快速地为您的 MAUI 应用程序添加 PDF 查看功能。
PDF 查看器工具栏提供哪些功能?
IronPDF Viewer 工具栏提供全面的功能,包括在页面间移动的导航控件、调整文档查看大小的缩放功能、查找 PDF 内文本的搜索功能以及直接从您的 MAUI 应用程序输出文档的打印选项。
IronPDF Viewer 可以加载不同来源的 PDF 吗?
是的,IronPDF Viewer 支持从多种来源加载 PDF,包括直接文件路径、字节数组和流。这种灵活性使您可以在 MAUI 应用程序中显示来自本地存储、内存或网络资源的 PDF。
IronPDF Viewer 适合企业应用吗?
IronPDF Viewer 是构建企业应用程序、文档管理系统和教育软件的理想选择。它使用与 IronPDF 核心库相同的渲染引擎,确保准确的文档显示和专业级的 PDF 查看功能,适合关键业务应用。

