Visualización de PDFs en MAUI para C# .NET
En la era moderna del desarrollo multiplataforma, ofrecer a los usuarios la posibilidad de ver documentos PDF directamente en su aplicación no es sólo una comodidad, sino una necesidad. Con el IronPDF Viewer, puedes incorporar la funcionalidad de visualización de PDF en tu aplicación MAUI.
En este artículo, aprenderemos a integrar IronPDF Viewer dentro de una aplicación MAUI para permitir a los usuarios la capacidad de ver, guardar e imprimir PDFs.
Visión general
Cómo ver PDFs en C# .NET MAUI APPs
- Descargue e instale la biblioteca IronPDF Viewer
- Integrar IronPDF Viewer en una aplicación MAUI
- Añadir una página de visor de PDF añadiendo XAML o C# ContentPage
- Cargar un PDF al iniciarse por nombre de archivo, matriz de bytes y secuencia
- Configurar la barra de herramientas
Descargue e instale la biblioteca del visor IronPDF
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Visual Studio - Gestor de paquetes NuGet
En Visual Studio, haz clic derecho en el explorador de soluciones de tu proyecto y selecciona Administrar paquetes NuGet.... Desde allí, puedes buscar IronPdf.Viewer.Maui e instalar la última versión en tu solución. Alternativamente, puedes abrir la consola del Administrador de Paquetes NuGet navegando a Tools > NuGet Packet Manager > Package Manager Console y escribiendo el siguiente comando:
Install-Package IronPdf.Viewer.Maui
Integrar IronPDF Viewer en una aplicación MAUI
En las siguientes secciones, demostraremos cómo integrar IronPDF Viewer en una aplicación MAUI predeterminada.
Configurar
Antes de añadir IronPDF Viewer a tu proyecto MAUI, asegúrate primero de que no está orientado a las plataformas iOS y Android. Puedes verificar esto haciendo clic derecho en el archivo del proyecto y seleccionando Propiedades. Desmarque las casillas Objetivo de la plataforma iOS y Objetivo de la plataforma Android subrayadas en la imagen a continuación si no están desmarcadas ya. Para que este cambio se aplique correctamente, es posible que tenga que guardar el proyecto después de desmarcar y reiniciar Visual Studio.
Después de desobjetivar las plataformas iOS y Android, ve a tu archivo MauiProgram.cs y añade el siguiente código para inicializar el visor:
: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();
}
}Por defecto, el Visor IronPDF mostrará un banner en la parte inferior derecha de la vista. Para eliminar esta vista, añade tu clave de licencia de IronPDF (o Iron Suite) a ConfigureIronPdfView de la siguiente manera:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs.ConfigureIronPdfView("YOUR-LICENSE-KEY");Añadir una página de visor de PDF
En esta sección, aprenderemos a crear una página de Visor PDF, integrar IronPDF Viewer y crear una pestaña para él en una aplicación MAUI. Demostraremos cómo hacer esto con un ContentPage tanto en XAML como en C#.
Pasos
Agregue una nueva página a su proyecto haciendo clic derecho en su proyecto, luego navegue a
Agregar > Nuevo elemento...
Navegue a la sección
.NET MAUI. Para crear una página XAML, seleccione.NET MAUI ContentPage (XAML). Para un archivo C#, seleccione.NET MAUI ContentPage (C#). Dale a tu archivo el nombre PdfViewerPage, luego haz clic enAdd.
- 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>Si en su lugar creó un ContentPage en C#, agregue el siguiente código y guarde:
: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;
}
}
- En su archivo AppShell.xaml, añada lo siguiente:
<?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>Guarde el proyecto, compílelo y ejecútelo. Debería ver pestañas en la esquina superior izquierda, como se muestra a continuación, y al hacer clic en la pestaña "Visor de PDF" se abrirá el Visor IronPDF.
Cargar un PDF al arrancar
Al iniciar la aplicación, IronPDF Viewer pedirá al usuario que abra un PDF de forma predeterminada. También es posible que abra un PDF automáticamente al iniciarse. Hay tres formas de cargar un PDF al iniciarse: mediante un nombre de archivo, a través de una matriz de bytes y a través de un flujo.
Cargar por nombre de archivo
Para cargar un PDF por nombre de archivo, puedes especificar la fuente del archivo PDF en la etiqueta IronPdfView en el archivo XAML. Un ejemplo de esto se muestra a continuación:
<?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, puede cargar el PDF por nombre de archivo utilizando el método IronPdfViewSource.FromFile en una 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");Carga a través de matriz de bytes
Para algunos casos de uso, puede ser conveniente cargar una matriz de bytes de un PDF. Esto no es posible desde XAML, pero sí en C#. Puedes lograr esto simplemente usando el método IronPdfViewSource.FromBytes. A continuación se muestra un ejemplo de cómo utilizar este método:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cspdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));Carga a través de la corriente
Del mismo modo, puede ser más conveniente que los PDF se carguen a través de un flujo en algunos casos de uso. Esto no es posible desde XAML, pero sí en C#. Puedes lograr esto simplemente utilizando el método IronPdfViewSource.FromStream. A continuación se muestra un ejemplo de cómo utilizar este método:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cspdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));Configurar la barra de herramientas
Con IronPDF Viewer, puede elegir qué opciones mostrar en la barra de herramientas. Las opciones disponibles son:
- Vista en miniatura
- Visualización del nombre del archivo
- Búsqueda de texto
- Navegación por el número de página
- Zoom
- Ajustar a la anchura
- Ajuste a la altura
- Girar en el sentido de las agujas del reloj
- Girar en sentido antihorario
- Abrir expediente
- Descargar archivo
- Imprimir archivo
- Mostrar anotaciones
Vista de dos páginas
Por defecto, IronPDF Viewer mostrará la barra de herramientas que se muestra a continuación:
En la vista por defecto, las opciones de visualización de nombre de archivo, búsqueda de texto y rotación en sentido contrario a las agujas del reloj están desactivadas. Para mostrar todo, establezca el parámetro
Optionde la etiquetaIronPdfViewen el XAML aAll:
<?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>Alternativamente, podría conseguir lo mismo en C#:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cspdfView.Options = IronPdfViewOptions.All;Que mostrará lo siguiente:
Si no desea mostrar nada, establezca la opción en None. La barra de herramientas no aparecerá si Options están configuradas de esta manera:
Puede elegir las opciones específicas que desea mostrar. Por ejemplo, si desea mostrar solo la miniatura y las opciones de abrir archivo, modifique el parámetro Options de IronPdfView en XAML de la siguiente manera:
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>Del mismo modo, en C#:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;Que mostrará lo siguiente:
Conclusión
En este tutorial, aprendimos a integrar IronPDF Viewer en una aplicación MAUI y a personalizar su barra de herramientas según tus necesidades.
Este visor viene con nuestro producto IronPDF. Si desea hacer una solicitud de característica o tiene preguntas generales sobre IronPDF Viewer (o IronPDF), por favor contacte a nuestro equipo de soporte. Estaremos encantados de ayudarle.
