在 MAUI for C# .NET 中查看 PDF

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

IronPDF 浏览器横幅

在现代跨平台开发时代,让用户能够在您的应用程序中直接查看PDF文档不仅是一种便利,更是一种必需。 使用 IronPDF Viewer,您可以将 PDF 查看功能嵌入到您的 MAUI 应用程序中。

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


概述


下载并安装 IronPDF 浏览器库

立即在您的项目中开始使用IronPDF,并享受免费试用。

第一步:
green arrow pointer

Visual Studio - NuGet 包管理器

在 Visual Studio 中,右键单击您的项目解决方案资源管理器,选择 管理 NuGet 包...,在此处,您可以搜索 IronPdf.Viewer.Maui 并将最新版本安装到您的解决方案中。 或者,您可以通过导航到 Tools > NuGet Packet Manager > Package Manager Console 打开 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.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
VB   C#

默认情况下,IronPDF 查看器将在视图的右下角显示一个横幅。 要移除此视图,请添加您的 IronPDF (或 铁套房)许可证密钥到 ConfigureIronPdfView 像这样:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

添加PDF查看器页面

在本节中,我们将学习如何在MAUI应用程序中创建一个PDF查看器页面,整合IronPDF Viewer,并为其创建一个标签页。 我们将展示如何使用XAML和C# ContentPage来实现这一点。

步骤

  1. 通过在项目上右键点击,然后导航到 添加 > 新建项... 来向您的项目中添加新页面。

    添加新项目

  2. 导航至 .NET MAUI 部分。 要创建一个XAML页面,请选择.NET MAUI ContentPage(XAML). 对于一个 C# 文件,请选择 .NET MAUI ContentPage(C#). 将文件命名为 PdfViewerPage,然后点击 Add

    .NET MAUI `内容页

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

如果您创建的是 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
VB   C#
  1. 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
  1. 保存您的项目,然后构建并运行。 您应该在左上角看到如下所示的标签页,点击“PDF 查看器”标签应该打开 IronPDF 查看器。

    IronPDF 查看器默认设置

启动时加载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

或者,您也可以在 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")
VB   C#

通过字节数组加载

对于某些用例,可能希望加载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"))
VB   C#

通过流加载

同样,在某些使用场景中,通过流加载 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"))
VB   C#

配置工具栏

使用IronPDF Viewer,您可以选择在工具栏中显示哪些选项。 可用的选项有:

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

    默认情况下,IronPDF Viewer 将显示下面的工具栏:

    默认工具栏

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

或者,您也可以用 C# 来实现同样的功能:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
VB   C#

将显示以下内容:

所有工具栏

如果您不想显示任何内容,请将选项设置为None。 如果将Options设置为此,则工具栏不会显示。

无工具栏

您可以选择您希望显示哪些特定选项。 例如,如果您只想显示缩略图和打开文件选项,请这样修改XAML中的IronPdfViewOptions参数:

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

同样,在 C#.NET Framework 中,".....:

: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
VB   C#

将显示以下内容:

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

结论

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

此查看器随我们的IronPDF产品一起提供。 如果您想提出功能请求或对IronPDF Viewer有任何一般性问题(或 IronPDF)请联系我们的支持团队. 我们将非常乐意为您提供帮助。