在 MAUI for C# .NET 中查看 PDFs
在跨平台开发的现代，为用户提供在应用程序中直接查看 PDF 文档的功能不仅是一种便利，更是一种必要。有了IronPDF Viewer，您就可以在您的MAUI应用程序中嵌入PDF查看功能。
在本文中，我们将学习如何在 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 中，右键单击项目解决方案资源管理器并选择 "Manage NuGet Packages..."，然后搜索 IronPdf.Viewer.Maui 并将最新版本安装到解决方案中。或者，您也可以打开 NuGet 包管理器控制台，方法是导航至 "工具 > NuGet 包管理器 > 包管理器控制台"，然后输入以下命令：
Install-Package IronPdf.Viewer.Maui
将 IronPDF Viewer 集成到 MAUI 应用程序中
在下面的章节中，我们将演示如何将 IronPDF Viewer 集成到默认的 MAUI 应用程序中。
设置
在将 IronPDF Viewer 添加到 MAUI 项目之前，首先要确保它不针对 iOS 和 Android 平台。您可以右键单击项目文件并选择属性进行检查。如果尚未选中下图中下划线的 Target the iOS Platform 和 Target the Android platform 复选框，请取消选中。要成功执行这一更改，您可能需要在取消选中后保存项目并重启 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 来完成此操作。
步骤
1.右键单击项目，然后导航至 "添加 > 新项目..."，在项目中添加新页面。
2.导航至".NET MAUI "部分。要创建 XAML 页面，请选择 .NET MAUI ContentPage (XAML).对于 C# 文件，选择".NET MAUI ContentPage (C#)`.将文件命名为 PdfViewerPage，然后点击 "添加"。
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>如果您创建的是 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>5.保存项目，然后构建并运行。如下图所示，你应该能在左上角看到选项卡，点击 "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，您可以选择在工具栏中显示哪些选项。可供选择的选项有
- 缩略图视图
- 显示文件名
- 文本搜索
- 页码导航
- 放大
- 适合宽度
- 适合高度
- 顺时针旋转
- 逆时针旋转
- 打开文件
- 下载文件
- 打印文件
- 显示注释
- 两页视图
默认情况下，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将显示如下内容
如果不想显示任何内容，请将该选项设置为 "无"。如果设置为 "选项"，则不会显示工具栏：
您可以选择要显示的具体选项。例如，如果你只想显示缩略图和打开文件选项，请在 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)请 联系我们的支持团队.我们将非常乐意为您提供帮助。
