Visualización de PDF en MAUI para 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 una página XAML como con una ContentPage en C#.

Pasos

1. Añade una nueva página a tu proyecto haciendo clic derecho en tu proyecto y 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#). Ponle a tu archivo el nombre 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 una ContentPage en C#, agrega el siguiente código en su lugar 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 IronPDF Viewer.

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

Alternativamente, puedes cargar el PDF por nombre de archivo usando el método IronPdfViewSource.FromFile en una ContentPage en 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")

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 usando el método IronPdfViewSource.FromBytes. 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"))

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 usando el método IronPdfViewSource.FromStream. 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"))