Visualización de PDF en MAUI para C#; .NET

En esta sección se explica cómo crear una página de visor de PDF, integrar IronPDF Viewer y crear una ficha para él en una aplicación MAUI. Lo demostramos con una ContentPage en XAML y C#. Elija el enfoque que mejor se adapte a su estilo de desarrollo y a los requisitos del proyecto.

¿Cuáles son los pasos para añadir una página de visor?

1. Añada una nueva página a su proyecto haciendo clic con el botón derecho del ratón en el proyecto y, a continuación, vaya a <código>Añadir > Nuevo elemento...` Menú Añadir de Visual Studio con Nuevo elemento, referencias y componentes de proyecto para el desarrollo de aplicaciones MAUI

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.
   Diálogo Añadir nuevo elemento de Visual Studio con .NET MAUI ContentPage (C#) seleccionado y nombre de archivo PdfViewerPage.cs introducido

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

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

<?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 en su lugar ha creado una ContentPage en C#, añada el siguiente código y guarde:

: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 su archivo AppShell.xaml, añada lo siguiente para crear pestañas de navegación:

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

<?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á ver las pestañas en la esquina superior izquierda, como se muestra a continuación. Al hacer clic en la pestaña "Visor de PDF" se abre el visor IronPDF. El visor ofrece una interfaz rica en funciones para la interacción con documentos PDF.

Interfaz predeterminada de IronPDF Viewer con tema oscuro que muestra el área de carga de archivos y el botón Examinar archivo

Al iniciar la aplicación, IronPDF Viewer solicita al usuario que abra un PDF de forma predeterminada. Sin embargo, puede abrir un PDF automáticamente al iniciarse, lo que mejora la experiencia del usuario para aplicaciones que necesitan mostrar documentos específicos inmediatamente. Puede cargar un PDF al iniciarse de tres formas: por nombre de archivo, a través de una matriz de bytes y a través de un flujo. Cada método ofrece ventajas diferentes en función de la fuente de datos y la arquitectura de la aplicación.

¿Cómo cargar por nombre de archivo?

Para cargar un PDF por nombre de archivo, especifique el origen del archivo PDF en la etiqueta IronPdfView del archivo XAML. Este es el método más sencillo cuando se trabaja con archivos locales:

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

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

Como alternativa, cargue el PDF por nombre de archivo mediante programación utilizando el método IronPdfViewSource.FromFile en una ContentPage de C#. Este enfoque ofrece más flexibilidad para la carga dinámica de archivos:

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

¿Cómo se carga una matriz de bytes?

Al trabajar con PDF almacenados en bases de datos o recibidos de servicios web, es posible que necesite cargar una matriz de bytes de un PDF. Esto no es posible desde XAML, pero se puede lograr en C# utilizando el método 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"))

Este método es útil cuando se integra con sistemas de gestión de documentos o cuando los PDF se generan dinámicamente utilizando las funciones de HTML a PDF de IronPDF.

¿Cómo se carga a través de Stream?

Para los PDF cargados a través de un flujo, especialmente cuando se trabaja con recursos de red o se implementa la carga progresiva, utilice el método IronPdfViewSource.FromStream en C#:

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

La carga basada en flujos es ideal para manejar PDF de gran tamaño de forma eficiente o para trabajar con flujos de documentos cifrados.