在 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 浏览器库
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.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 查看器将在视图的右下角显示一个横幅。 要移除此视图，请添加您的 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.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 文件中添加以下内容：
<?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.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，您可以选择在工具栏中显示哪些选项。 可用的选项有：
- 缩略图视图
- 文件名显示
- 文本搜索
- 页码导航
- 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.cspdfView.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.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open将显示以下内容：
结论
在本教程中，我们学习了如何将IronPDF Viewer集成到MAUI应用程序中，以及如何自定义其工具栏以最佳满足您的需求。
此查看器随我们的IronPDF产品一起提供。 如果您想提出功能请求或对IronPDF Viewer有任何一般性问题(或 IronPDF)请联系我们的支持团队. 我们将非常乐意为您提供帮助。
