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

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

IronPDF .NET Maui PDF Viewer 横幅,显示在查看器中渲染图表和图解的复杂技术文档

跨平台应用程序通常需要在应用程序中直接显示 PDF 文档。IronPDF Viewer 可让您在 MAUI 应用程序中嵌入 PDF 查看功能,实现跨 WindowsmacOS 平台的文档查看。

IronPDF Viewer 是一个基于 IronPDF 库的组件,为 PDF 操作和查看提供了全面的解决方案。 它提供了与 .NET MAUI 应用程序的本地集成,可实现跨平台的一致性能。

本文展示了如何在 MAUI 应用程序中集成 IronPDF Viewer,以允许用户查看、保存和打印 PDF。 无论您是在构建企业应用程序、文档管理系统还是教育软件,本指南都将帮助您实现 PDF 浏览功能。

快速入门:在 MAUI 中使用 IronPDF 查看 PDF

将 IronPDF 集成到您的 MAUI 应用程序中,立即开始查看 PDF。 本代码片段演示了如何实例化 IronPDF PdfViewer 并加载 PDF 文件以供查看。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronPDF

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronPDF,免费试用!
    arrow pointer


如何下载和安装 IronPDF Viewer 库?

如何通过 NuGet 包管理器进行安装?

在 Visual Studio 中,右键点击解决方案资源管理器中的项目并选择管理 NuGet 包... 从那里,搜索 IronPdf.Viewer.Maui 并将最新版本安装到您的解决方案中。 有关更详细的安装指导,请查阅我们的 安装概述。 或者,通过导航至 Tools > NuGet Package Manager > Package Manager Console 并输入以下命令来打开 NuGet Package Manager 控制台:

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 桌面平台。 通过右键单击项目文件并选择 属性来检查。 如果选中了针对 iOS 平台针对 Android 平台复选框,请取消选中。 要使此更改生效,请在取消选中后保存项目并重新启动 Visual Studio。

!a href="/static-assets/pdf/tutorials/pdf-viewing/properties_screen_underlined.png">MAUI 项目属性,显示使用 .NET 7.0 Framework 启用的 iOS、Android 和 Windows 平台目标。

在取消 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 会在视图右下方显示一个横幅。 要移除此横幅并解锁所有功能,请在 ConfigureIronPdfViewer 中添加您的 IronPDF(或 Iron Suite)许可证密钥:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
.ConfigureIronPdfView("YOUR-LICENSE-KEY")
$vbLabelText   $csharpLabel

有关获取和应用许可证密钥的详细信息,请参阅我们的许可证密钥指南

如何添加 PDF 查看器页面?

本节介绍如何在 MAUI 应用程序中创建 PDF 查看器页面、集成 IronPDF Viewer 并为其创建一个选项卡。 我们使用 XAML 和 C# ContentPage 进行了演示。 选择最适合您的开发风格和项目要求的方法。

添加查看器页面的步骤是什么?

1.右键单击您的项目,然后导航至 Add > New Item...,为您的项目添加一个新页面。 !Visual Studio 添加菜单,显示用于 MAUI 应用程序开发的新建项、引用和项目组件

  1. 导航到 .NET MAUI 部分。 要创建一个 XAML 页面,请选择.NET MAUI ContentPage (XAML)。 对于 C# 文件,选择.NET MAUI ContentPage (C#)。 给予您的文件名称为 PdfViewerPage,然后点击 添加
    Visual Studio 添加新项目对话框,选择 .NET MAUI ContentPage (C#) 并输入 PdfViewerPage.cs 文件名

  2. 在 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 而不是,请添加以下代码并保存:

: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

4.在您的 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
  1. 保存您的项目,然后构建并运行。 您应在左上角看到如下所示的选项卡。 点击 "PDF 查看器 "选项卡可打开 IronPDF 查看器。 阅读器为 PDF 文档交互提供了功能丰富的界面。

暗色主题的 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

或者,使用 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 时,您可能需要加载 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

在与文档管理系统集成或使用 IronPDF的 HTML 转 PDF 功能动态生成 PDF 时,这种方法非常有用。

如何通过流加载?

对于通过流加载的 PDF,尤其是在使用网络资源或实现渐进式加载时,请使用 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

基于流的加载是高效处理大型 PDF 或处理加密文档流的理想选择。

如何配置工具栏?

使用 IronPDF Viewer,您可以选择在工具栏中显示哪些选项,从而为您的应用程序需求提供可定制的用户体验。 工具栏配置系统非常灵活,只显示用户需要的功能。可用选项包括

  • 缩略图视图
  • 文件名展示
  • 文本搜索
  • 页码导航
  • 缩放
  • 适合宽度
  • 适合高度
  • 顺时针旋转
  • 逆时针旋转
  • 打开文件
  • 下载文件
  • 打印文件
  • 显示注释
  • 双页视图

默认情况下,IronPDF Viewer 会显示下图所示的工具栏:

!a href="/static-assets/pdf/tutorials/pdf-viewing/toolbar_all.png">IronPDF Viewer 默认工具栏显示导航、缩放、页面选择和文件操作控制。

在默认视图中,文件名显示、文本搜索和逆时针旋转选项被禁用。 要显示所有内容,请将 XAML 中 IronPdfView 标记的 Options 参数设置为 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

或者,用 C# 实现同样的效果:

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

此显示:

暗色主题界面中显示导航、缩放和文件控件的 IronPDF Viewer 完整工具栏

要完全隐藏工具栏,请将该选项设置为 None

空工具栏配置界面,显示带有导航箭头的勾画占位符区域

您可以选择要显示的特定选项。 例如,要只显示缩略图和打开文件选项,请修改 XAML 中 IronPdfViewOptions 参数:


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

<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

此显示:

默认配置中显示菜单图标、徽标和 "选择文件 "按钮的 IronPDF Viewer 工具栏

这种对工具栏选项的细粒度控制可让您创建符合自己应用程序要求的浏览体验。 例如,您可能会限制在安全文档查看器中下载,或简化基本查看场景的界面。

结论

本教程介绍了如何将 IronPDF Viewer 集成到 MAUI 应用程序中,并根据自己的需要自定义其工具栏。 IronPDF Viewer 提供强大的 PDF 浏览体验,只需最少的代码即可无缝集成到您的 .NET MAUI 应用程序中。

该阅读器可以灵活地从各种来源(文件、字节数组和流)加载 PDF,因此适用于从简单的文档阅读器到复杂的文档管理系统等多种应用。 结合广泛的工具栏自定义选项,您可以创建用户所需的确切查看体验。

该阅读器附带有我们的 IronPDF 产品,其中还包括强大的 PDF生成编辑操作功能。 如果您想提出功能请求或对 IronPDF Viewer(或 IronPDF)有任何一般问题,请联系我们的支持团队。 我们将竭诚为您服务。

有关更高级的 PDF 操作,请浏览我们全面的 PDF 查看指南,或了解 应用许可密钥,以充分释放 IronPdf 在您的应用程序中的潜力。

常见问题解答

什么是 IronPDF Viewer for .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 查看功能,适合关键业务应用。

Jordi Bardia
软件工程师
Jordi 最擅长 Python、C# 和 C++,当他不在 Iron Software 利用这些技能时,他就在游戏编程。分享产品测试、产品开发和研究的责任,Jordi 在持续的产品改进中增加了巨大的价值。多样的经验使他面临挑战并保持投入,他表示这是在 Iron Software 工作的最喜欢的方面之一。Jordi 在佛罗里达州迈阿密长大,并在佛罗里达大学学习计算机科学和统计学。
准备开始了吗?
Nuget 下载 17,386,124 | 版本: 2026.2 刚刚发布