1. IronPDF
  2. 操作指南
  3. 在 .NET MAUI 中查看 PDF 文件

Viewing PDFs in MAUI for C# .NET

Jordi Bardia
Jordi Bardia
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF Viewer Banner

在现代跨平台开发时代，提供用户直接在你的应用中查看 PDF 文档的能力，不仅是方便，而是必需的。 通过 IronPDF Viewer，您可以在 MAUI 应用程序中嵌入 PDF 查看功能。

在本文中，我们将学习如何在 MAUI 应用程序中集成 IronPDF Viewer，以便让用户能够查看、保存和打印 PDF。

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

轻松地将 IronPDF 集成到您的 MAUI 应用程序中，开始无缝查看 PDF。 这个简单的代码片段演示了如何实例化 IronPDF PdfViewer 并加载 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.

    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。

Properties Screen

在取消以 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

添加一个 PDF 查看页面

在本节中，我们将学习如何创建一个 PDF 查看页面，集成 IronPDF Viewer，并在 MAUI 应用程序中为其创建一个标签。 我们将演示如何通过 XAML 和 C# ContentPage 来实现这一点。

步骤

  1. 通过右键点击您的项目并导航到添加 > 新建项目... 添加一个新页面到您的项目
    Add New Item

  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 查看器”标签应该会打开 IronPDF Viewer。

IronPDF Viewer Default

在启动时加载 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 将显示如下工具栏：

Default Toolbar

在默认视图中，文件名显示、文本搜索和逆时针旋转选项都被禁用。 要显示所有内容，请将 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

这样将会显示如下：

All Toolbar

如果您不想显示任何内容，请将选项设置为None。 如果Options被设置为这个，工具栏将不会出现：

No Toolbar

您可以选择希望显示哪些特定选项。 例如，如果您想显示仅缩略图和打开文件选项，则在 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

这样将会显示如下：

具有缩略图和打开文件选项的工具栏

结论

在本教程中，我们学习了如何将 IronPDF Viewer 集成到 MAUI 应用程序中，并如何自定义其工具栏以最佳满足您的需求。

该查看器附带我们的 IronPDF 产品。 如果您想提出功能请求或对 IronPDF Viewer（或 IronPDF）有任何一般问题，请联系我们的支持团队。 我们将非常乐意为您提供帮助。

常见问题解答

我怎样才能在 MAUI 应用程序中查看 PDF？

要在 MAUI 应用程序中查看 PDF，可以通过在 Visual Studio 中从 NuGet 包管理器安装 IronPDF 查看器，并将所需代码添加到项目中来集成。

在 MAUI 应用程序中集成 PDF 查看器需要什么步骤？

确保你的 MAUI 项目兼容，通过 NuGet 下载 IronPDF 查看器库，并在 _MauiProgram.cs_ 文件中使用你的 IronPDF 许可证密钥初始化查看器。

我的 MAUI 应用程序启动时如何加载 PDF 文件？

可以通过在 XAML 文件中设置源，或在 C# ContentPage 中使用 IronPdfViewSource.FromFile、FromBytes 或 FromStream 等方法在启动时加载 PDF。

如何在 MAUI 的 PDF 查看器中自定义工具栏？

通过在 XAML 或 C# 代码中配置 'Options' 参数来自定义工具栏，以包括缩略图视图、文本搜索、缩放等功能，或设置为 'All' 以获得全部功能。

是否可以在 MAUI PDF 查看器中隐藏工具栏？

是的，通过将 'Options' 参数设置为 'None'，可以隐藏工具栏并防止显示任何工具。

MAUI 中 PDF 查看器的一些常见故障排除步骤是什么？

确保通过 NuGet 正确安装了 IronPDF 查看器，检查项目的兼容性，并验证项目文件中是否正确实现了任何必要代码，例如许可证密钥初始化。

我可以在目标为 iOS 或 Android 的 MAUI 应用程序中使用 PDF 查看器吗？

IronPDF 查看器目前不支持目标为 iOS 或 Android 平台的 MAUI 项目。请确保你的项目目标是兼容的平台。

我如何提出功能请求或获得关于 PDF 查看器的支持？

对于功能请求或支持，请通过 IronPDF 官方网站联系支持团队以获取有关 PDF 查看器的帮助。

IronPDF Viewer 是否兼容 MAUI 项目中的 .NET 10？

是的——IronPDF 完全兼容 .NET 10，就像它兼容之前的版本，例如 .NET 6、.NET 7 和 .NET Core 一样。这意味着在面向 .NET 10 的 MAUI 应用程序中使用 IronPDF 无需任何特殊配置或变通方法。

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