在 MAUI for C# .NET 中查看 PDF.

在现代跨平台开发时代,提供用户直接在你的应用中查看 PDF 文档的能力,不仅是方便,而是必需的。 通过 IronPDF Viewer,您可以在 MAUI 应用程序中嵌入 PDF 查看功能。
在本文中,我们将学习如何在 MAUI 应用程序中集成 IronPDF Viewer,以便让用户能够查看、保存和打印 PDF。
快速开始:在 MAUI 中实现 IronPDF Viewer
通过几行代码即可在您的 MAUI 应用程序中开始集成 IronPDF Viewer。 本快速指南展示了如何无缝加载 PDF 文件,使用 IronPDF 强大的库。 这种方法非常适合渴望通过流畅 PDF 查看功能增强应用程序的开发者,强调操作简便性和快速实施。 简单地初始化 IronPDF Viewer 并加载您的 PDF,使您的应用中可以方便地查看 PDF。
立即开始使用 NuGet 创建 PDF 文件:
使用 NuGet 包管理器安装 IronPDF
复制并运行这段代码。
var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };部署到您的生产环境中进行测试
最小工作流程(5 个步骤)
- 下载并安装 IronPDF Viewer 库。
- 将 IronPDF 查看器集成到 MAUI 应用程序中
- 通过添加 XAML 或 C# ContentPage 来添加 PDF 查看器页面
- 通过文件名、字节数组和流在启动时加载 PDF
- 配置工具栏
下载并安装 IronPDF Viewer 库
今天在您的项目中使用 IronPDF,免费试用。
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.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 会在视图右下角显示一个横幅。 若要移除此视图,请像这样在ConfigureIronPdfViewer中添加您的 IronPDF(或 Iron Suite)许可证密钥:
: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 Viewer,并在 MAUI 应用程序中为其创建一个标签。 我们将演示如何通过 XAML 和 C# ContentPage 来实现这一点。
步骤
通过右键点击您的项目并导航到
添加 > 新建项目...添加一个新页面到您的项目
导航到
.NET MAUI部分。 要创建一个 XAML 页面,请选择.NET MAUI ContentPage (XAML)。 对于 C# 文件,选择.NET MAUI ContentPage (C#)。 给予您的文件名称为 PdfViewerPage,然后点击添加。
- 在 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 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>或者,您可以通过使用 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)有任何一般问题,请联系我们的支持团队。 我们将非常乐意为您提供帮助。
常见问题解答
如何在使用C#的MAUI应用程序中查看PDF?
要在使用C#的MAUI应用程序中查看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文件?
在启动时加载PDF文件,使用IronPDF Viewer方法,如IronPdfViewSource.FromFile、FromBytes或FromStream。
IronPDF Viewer的工具栏配置选项有哪些?
IronPDF Viewer的工具栏可以自定义,包括缩略图视图、文本搜索、页面导航、缩放、旋转和文件操作等选项。根据需求,可以设置为显示所有选项、不显示或仅显示特定工具。
如何自定义PDF Viewer工具栏以显示特定工具?
要自定义工具栏以显示特定工具,调整XAML或C#代码中的'Options'参数,仅包含所需选项,如'ThumbnailView,OpenFile'。
是否可以隐藏IronPDF Viewer的工具栏?
是的,可以通过将'Options'参数设置为'None'来隐藏工具栏,这会从查看器界面中移除工具栏。
如何解决MAUI应用程序中的PDF渲染问题?
如果在MAUI应用程序中遇到PDF渲染问题,请确保正确安装和配置了IronPDF库。此外,检查特定平台的限制或寻求IronPDF技术团队的支持。
在哪里可以找到将IronPDF Viewer集成到MAUI应用中的支持?
可以通过IronPDF的官方网站联系他们的支持团队,获取与将IronPDF Viewer集成到MAUI应用相关的任何帮助或功能请求。
IronPDF Viewer 是否完全兼容 .NET 10 项目?
是的。IronPDF 的所有主要产品线均支持 .NET 10,包括 MAUI 应用的 Viewer 组件。IronPDF Viewer 包兼容 net10.0-windows 和 net10.0-maccatalyst 等目标框架,使开发人员能够将 PDF 查看功能嵌入到基于 .NET 10 的桌面项目中,而无需任何变通方案。






