USO DE IRONPDF

Cómo mostrar PDF de matriz de bytes en Blazor

Regan Pun
Regan Pun
8 de mayo, 2023
Actualizado 10 de marzo, 2024
Compartir:

1. Introducción

IronPDF para Soluciones y Documentación PDF en C# es una biblioteca PDF de C# que admite la manipulación de renderizado de PDF y la conversión de matrices de bytes a archivos PDF. También permite revisar e imprimir archivos PDF; También permite revisar PDF con herramientas de anotación. Añadir encabezados y pies de página, y fusionar varios PDF también es muy cómodo con IronPDF.

IronPDF puede utilizarse con el visor de PDF Blazor para crear un visor de PDF, y puede manejar archivos de mayor tamaño creando una URL de objeto que el navegador puede mostrar.

Utilizando IronPDF con Blazor, los desarrolladores pueden crear un visor de PDF que puede mostrar archivos PDF desde matrices de bytes o desde un nombre de archivo, y también admite la carga de archivos y la gestión de descargas de archivos. IronPDF también proporciona un método para manejar la paginación de documentos PDF, que funciona bien con Blazor.

Además, IronPDF proporciona ejemplos de código para convertir matrices de bytes a documentos PDF, descargar archivos PDF y mostrar PDFs desde una cadena base64. Los desarrolladores también pueden convertir archivos PDF a otros formatos de archivo, como transformar imágenes en documentos PDF.

IronPDF puede utilizarse con una aplicación de servidor Blazor e integrarse con Visual Studio para ofrecer una experiencia de desarrollo perfecta. Con IronPDF, los desarrolladores pueden crear un componente de interfaz de usuario de nivel profesional que se puede utilizar para crear aplicaciones Web modernas y ricas en funciones.

Este artículo explica cómo los desarrolladores pueden utilizar IronPDF para convertir matrices de bytes PDF en documentos PDF y mostrarlos en un visor Blazor PDF.

2. Requisitos

Para seguir el tutorial, se necesitan las siguientes herramientas y requisitos:

  • Visual Studio 2019 o posterior: Esto es necesario para crear y ejecutar la aplicación Blazor. Se puede descargar desde el sitio web oficial de Visual Studio
  • .NET 5.0 o posterior: Esto es necesario para construir y ejecutar la aplicación Blazor. Se puede descargar desde la página oficial de descarga de .NET
  • IronPDF: Esta es la biblioteca de interfaz de usuario de nivel profesional que se utilizará para convertir matrices de bytes PDF en un documento PDF y mostrarlo en el visor Blazor PDF. Se puede descargar desde el sitio web oficial de IronPDF
  • Paquete NuGet IronPDF.Blazor: Este es el paquete NuGet que se utilizará para integrar IronPDF con la aplicación Blazor. Puede instalarse desde el gestor de paquetes NuGet dentro de Visual Studio.

    Algunas de las funciones descritas en el tutorial pueden requerir una versión de pago de IronPDF. Además, el tutorial asume un conocimiento básico de Blazor y C#.

3. Creación de una aplicación Blazor

Debemos crear un nuevo proyecto de Visual Studio antes de que podamos empezar a construir nuestra primera aplicación Blazor.

  • Abre Visual Studio.
  • Haga clic en Crear un nuevo proyecto.
  • Se debe elegir Blazor Server App Template.

    Cómo mostrar PDF desde una matriz de bytes en Blazor, Figura 1: Creando un nuevo proyecto en Visual Studio

    Crear un nuevo proyecto en Visual Studio

  • Seleccione la opción Siguiente.
  • El nombre de su aplicación.

    Cómo mostrar PDF desde una matriz de bytes en Blazor, Figura 2: Creación de un nuevo proyecto en Visual Studio

    Crear un nuevo proyecto en Visual Studio

  • Seleccione la opción Siguiente.
  • Seleccione un .NET Framework

    Cómo mostrar PDF desde una matriz de bytes en Blazor, Figura 3: Elegir el .NET 6.0 Framework para la nueva aplicación de servidor Blazor

    Elegir el framework .NET 6.0 para la nueva aplicación del servidor Blazor

  • Haz clic en el Crear botón.
  • Como se ve a continuación, se creará un nuevo proyecto.

    Cómo mostrar PDF desde un Byte Array en Blazor, Figura 4: Qué es Blazor y cómo funciona

    ¿Qué es Blazor y cómo funciona?

    Para ofrecerle un programa Blazor sencillo y listo para usar, se han creado varios archivos.

  • El punto de entrada para la aplicación que inicia el servidor es program.cs, donde también configuras el middleware y los servicios para la aplicación.
  • La parte principal de la aplicación se llama "App.razor".
  • En el directorio Páginas encontrará algunos ejemplos de páginas web para la aplicación.
  • En el archivo "launchSettings.json", ubicado en el directorio Properties, se definen diferentes configuraciones de perfil para el entorno de desarrollo local. Cuando se crea un proyecto, se le asigna automáticamente un número de puerto y se guarda en este archivo.

    Inicie el programa de plantillas.

Tipos de proyectos Blazor

Blazor soporta dos tipos de proyectos: Blazor Server y Blazor WebAssembly.

El primer tipo se ejecuta en el servidor y utiliza SignalR para comunicarse con el navegador. Esto significa que la interfaz de usuario de la aplicación se renderiza en el servidor, y el navegador sólo recibe actualizaciones del servidor. Blazor Server tiene la ventaja de ser capaz de soportar aplicaciones más grandes y puede manejar fácilmente más usuarios.

En cambio, las aplicaciones Blazor WebAssembly se ejecutan íntegramente en el navegador y no necesitan un servidor para funcionar. Esto los hace más ligeros y rápidos de cargar, pero tienen algunas limitaciones, como que no admiten archivos de mayor tamaño.

Para este tutorial, se recomienda utilizar una aplicación Blazor Server, ya que puede soportar la visualización y el manejo de archivos PDF, que pueden ser más grandes. Además, Blazor Server admite la revisión e impresión de PDF, lo que puede ser una función útil para una aplicación de visualización de PDF.

Instalación de IronPDF

En esta sección, discutiremos cómo instalar IronPDF utilizando diferentes métodos

Utilizar la línea de comandos

Vaya a Herramientas > Administrador de paquetes NuGet > Consola del administrador de paquetes en Visual Studio.

Introduzca la siguiente línea en la pestaña terminal del gestor de paquetes:

Install-Package IronPdf

Ahora que el paquete ha sido descargado, el proyecto actual lo tendrá instalado.

Cómo mostrar PDF desde un arreglo de bytes en Blazor, Figura 5: Interfaz de usuario de la consola del administrador de paquetes

Interfaz de la Consola del Administrador de Paquetes

Uso de la gestión de paquetes NuGet para soluciones

La interfaz de usuario del gestor de paquetes NuGet está disponible en Visual Studio para instalar el paquete directamente en el proyecto. La siguiente captura de pantalla muestra cómo abrirlo.

Cómo mostrar PDF desde una matriz de bytes en Blazor, Figura 6: Navegar al Administrador de Paquetes NuGet

Navegar al Administrador de Paquetes NuGet

La interfaz de usuario del gestor de paquetes ofrece una función Examinar que muestra una lista de las bibliotecas de paquetes que se ofrecen en el sitio web de NuGet. Introduzca la palabra clave "IronPDF", como en la siguiente captura de pantalla, para encontrar el paquete IronPDF.

Cómo mostrar un PDF desde una matriz de bytes en Blazor, Figura 7: Buscar e instalar el paquete IronPDF en la interfaz de usuario de NuGet Package Manager

Buscar e instalar el paquete IronPDF en la interfaz de usuario del Administrador de Paquetes NuGet

Localice la biblioteca de IronPDF en el Administrador de Paquetes NuGet buscándola en la sección Explorar.

Seleccione el paquete IronPDF y haga clic en el botón "Instalar" para añadirlo al proyecto.

4. Creación y visualización de PDF a partir de matrices de bytes

Para generar matrices de bytes PDF utilizando IronPDF en una aplicación Blazor, primero tiene que añadir la dependencia IronPDF a su proyecto.

Una vez que haya añadido la dependencia IronPDF a su aplicación Blazor, puede crear un documento PDF utilizando el siguiente código:

string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

El fragmento de código mencionado utiliza primero el método RenderUrlAsPdf Method Documentation de IronPDF, que descarga el texto HTML de una URL especificada y lo convierte en formato PDF. El fragmento de código renderiza el material PDF resultante como una cadena de datos base64 sin procesar y lo guarda en una variable local.

Las aplicaciones pueden guardar los archivos PDF creados en el sistema de archivos del servidor para su acceso posterior utilizando la documentación de la función SaveAs de IronPDF (accesible en cada documentación de la instancia de ChromePdfRenderer).

En la siguiente sección del código se preparan los datos PDF en base64 para ser enviados al navegador del cliente.

@if (_url != string.Empty)
{

}
@if (_url != string.Empty)
{

}

La función antes mencionada vincula los datos base64 al atributo src de un elemento iframe después de recibirlos del servidor de Blazor en el lado del servidor. Esto provoca que los navegadores utilicen sus visores web integrados para renderizar el contenido Base64 como un documento PDF apropiado tan pronto como la página se carga.

A continuación se muestra una imagen de un archivo PDF generado a partir de una cadena base64.

Cómo Mostrar un PDF Desde una Matriz de Bytes en Blazor, Figura 8: Visualizando un PDF Generado en una aplicación Blazor en el navegador

Visualización de un PDF generado en una aplicación Blazor en el navegador

Creación de archivos PDF sencillos

He aquí un fragmento de código de ejemplo para crear un documento PDF sencillo utilizando IronPDF en C#:

var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")

Utilizando el método descrito en la sección anterior, se puede utilizar el navegador de un cliente para ver el documento PDF creado.

6. Conclusión

El tutorial muestra cómo utilizar las capacidades y tutoriales de IronPDF para crear y mostrar documentos PDF en una aplicación Blazor Server. Primero presenta IronPDF y sus capacidades, incluyendo cómo convertir HTML a PDF, añadir encabezados y pies de página personalizados, y unir múltiples PDFs. A continuación, proporciona instrucciones paso a paso para instalar IronPDF, crear un archivo PDF en una aplicación de Blazor Server y, a continuación, convertirlo en una matriz de bytes PDF y mostrarlo en el visor de PDF de Blazor mediante iframe.

En general, el tutorial proporciona una visión general de cómo trabajar con IronPDF y Blazor para crear y mostrar documentos PDF. Anima a los lectores a seguir experimentando con IronPDF y a probar distintas funciones para crear aplicaciones ricas en prestaciones.

Si estás interesado en probar IronPDF en tu proyecto Blazor, puedes aprovechar la prueba gratuita de IronPDF. Así tendrá tiempo de sobra para experimentar con las características y funcionalidades de la biblioteca y ver si satisface sus necesidades.

Para comenzar, puedes consultar la Documentación de IronPDF para Blazor, que ofrece información detallada sobre cómo usar la biblioteca en tu proyecto. También puede explorar el Blog y Tutoriales de IronPDF para encontrar tutoriales y artículos que abarcan una variedad de temas relacionados con la manipulación y renderización de PDF.

Le animamos a que se tome su tiempo para seguir experimentando con IronPDF y Blazor y vea cómo pueden mejorar sus esfuerzos de desarrollo relacionados con PDF. Para obtener más información sobre el visor de PDF de Blazor, consulte el siguiente Tutorial del visor de PDF de IronPDF Blazor.

Regan Pun
Ingeniero de software
Regan se licenció en Ingeniería Electrónica por la Universidad de Reading. Antes de incorporarse a Iron Software, sus anteriores puestos de trabajo le obligaban a centrarse en tareas concretas; lo que más le gusta de Iron Software es la variedad de tareas que puede realizar, ya sea añadiendo valor a las ventas, el soporte técnico, el desarrollo de productos o el marketing. Le gusta entender cómo utilizan los desarrolladores la biblioteca de Iron Software y utilizar ese conocimiento para mejorar continuamente la documentación y desarrollar los productos.
< ANTERIOR
Cómo guardar un archivo PDF en C# (Tutorial para principiantes)
SIGUIENTE >
Cómo desproteger un PDF (Tutorial para principiantes)