Viewing PDFs in MAUI for C# .NET

En esta sección, aprenderemos cómo crear una página de visor de PDF, integrar IronPDF Viewer y crear una pestaña para esta en una aplicación MAUI. Demostraremos cómo hacer esto tanto con un ContentPage de XAML como de C#.

Pasos

1. Agrega una nueva página a tu proyecto haciendo clic derecho sobre tu proyecto, luego navega a Add > New Item...

2. Navega a la sección .NET MAUI. Para crear una página XAML, selecciona .NET MAUI ContentPage (XAML). Para un archivo C#, selecciona .NET MAUI ContentPage (C#). Nombra tu archivo PdfViewerPage, luego haz clic en Add.

3. En el archivo XAML, añade el siguiente código y guarda:

: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>

Si creaste un ContentPage de C# en su lugar, agrega el siguiente código y guarda:

: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

4. En tu archivo AppShell.xaml, añade lo siguiente:

: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>

5. Guarda tu proyecto, luego compila y ejecuta. Deberías ver pestañas en la esquina superior izquierda como se muestra a continuación, y al hacer clic en la pestaña "PDF Viewer" debería abrirse el visor de IronPDF.

Al iniciar la aplicación, IronPDF Viewer pedirá al usuario que abra un PDF por defecto. También es posible que abra un PDF automáticamente al arrancar. Hay tres maneras de cargar un PDF al arranque: por nombre de archivo, a través de un array de bytes y a través de un stream.

Cargar por nombre de archivo

Para cargar un PDF por nombre de archivo, podrías especificar la fuente del archivo PDF en la etiqueta IronPdfView en el archivo XAML. Un ejemplo de esto se muestra a continuación:

: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>

IronPdfViewSource.FromFile

Alternativamente, puedes cargar el PDF por nombre de archivo utilizando el método LoadFromFilename() en un ContentPage de C#:

: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")

IronPdfViewSource.FromBytes

Carga a través de matriz de bytes

Para algunos casos de uso, puede ser deseable cargar un array de bytes de un PDF. Esto no es posible desde XAML, pero es posible en C#. Puedes lograr esto simplemente utilizando el método LoadFromByteArray(). Un ejemplo de cómo usar este método se muestra a continuación:

: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"))

IronPdfViewSource.FromStream

Carga a través del flujo

De manera similar, puede ser más deseable que los PDFs sean cargados a través de un stream en algunos casos de uso. Esto no es posible desde XAML, pero es posible en C#. Puedes lograr esto simplemente utilizando el método LoadFromStream(). Un ejemplo de cómo usar este método se muestra a continuación:

: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"))

Option