在 MAUI for C# .NET 中查看 PDF
在现代跨平台开发时代,让用户能够在您的应用程序中直接查看PDF文档不仅是一种便利,更是一种必需。 使用 IronPDF Viewer,您可以将 PDF 查看功能嵌入到您的 MAUI 应用程序中。
在本文中,我们将学习如何在MAUI应用程序中集成IronPDF Viewer,以便用户能够查看、保存和打印PDF文件。
概述
如何在 C# .NET MAUI APP 中查看 PDFs
- 下载并安装 IronPDF Viewer 库
- 将 IronPDF Viewer 集成到 MAUI 应用程序中
- 通过添加 XAML 或 C# ContentPage 来添加 PDF 浏览器页面
- 启动时按文件名、字节阵列和流加载 PDF
- 配置工具栏
下载并安装 IronPDF 浏览器库
立即在您的项目中开始使用IronPDF,并享受免费试用。
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
默认情况下,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
添加PDF查看器页面
在本节中,我们将学习如何在MAUI应用程序中创建一个PDF查看器页面,整合IronPDF Viewer,并为其创建一个标签页。 我们将展示如何使用XAML和C# ContentPage
来实现这一点。
步骤
通过在项目上右键点击,然后导航到
添加 > 新建项...
来向您的项目中添加新页面。导航至
.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"
...>
<ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>
如果您创建的是 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
- 在 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>
保存您的项目,然后构建并运行。 您应该在左上角看到如下所示的标签页,点击“PDF 查看器”标签应该打开 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>
或者,您也可以在 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.cs
pdfView.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.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))
配置工具栏
使用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>
或者,您也可以用 C# 来实现同样的功能:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
将显示以下内容:
如果您不想显示任何内容,请将选项设置为None
。 如果将Options
设置为此,则工具栏不会显示。
您可以选择您希望显示哪些特定选项。 例如,如果您只想显示缩略图和打开文件选项,请这样修改XAML中的IronPdfView
的Options
参数:
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
同样,在 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
将显示以下内容:
结论
在本教程中,我们学习了如何将IronPDF Viewer集成到MAUI应用程序中,以及如何自定义其工具栏以最佳满足您的需求。
此查看器随我们的IronPDF产品一起提供。 如果您想提出功能请求或对IronPDF Viewer有任何一般性问题(或 IronPDF)请联系我们的支持团队. 我们将非常乐意为您提供帮助。