IronPDF, una reconocida biblioteca de C#, funciona con aplicaciones Blazor. Esta reseña te guiará en el uso de IronPDF para incrustar un informe PDF en una aplicación Blazor, mostrando su integración impecable y efectividad.

1. Características de IronPDF

Los desarrolladores pueden crear, leer y procesar rápidamente un documento PDF con la ayuda de la robusta biblioteca IronPDF for .NET PDF. IronPDF tiene un motor de Chrome incorporado y ofrece una gran cantidad de capacidades prácticas y potentes. Estas incluyen la capacidad de convertir HTML5, JavaScript, CSS e imágenes a PDF, la capacidad de añadir encabezados y pies de página únicos a documentos PDF, y la capacidad de producir PDFs tal como aparecen en un navegador web. IronPDF es compatible con varias tecnologías web, incluidas HTML, ASPX, Razor Pages y marcos MVC.

Las características clave de IronPDF son las siguientes:

• IronPDF ofrece control total sobre la creación y modificación de archivos PDF dentro de aplicaciones .NET C#
• IronPDF puede generar archivos PDF de páginas web desde sus URLs utilizando configuraciones específicas de User-Agent, Proxy, Header y Cookie.
• IronPDF puede generar archivos PDF para páginas web ubicadas detrás de formularios de inicio de sesión usando variables de formulario
• IronPDF puede extraer y/o eliminar fotos de archivos PDF preexistentes
• IronPDF puede añadir texto, fotos, marcadores, marcas de agua y otros elementos a documentos PDF
• IronPDF facilita la fusión y división de páginas de uno o más documentos PDF.
• IronPDF puede procesar activos de página web como JavaScript, CSS y archivos multimedia y renderizarlos en documentos PDF tal como aparecerían en un navegador.
• IronPDF es compatible con todos los marcos .NET, incluidos .NET Core, .NET Standard, etc.

2. ¿Qué es Blazor?

Blazor es un Framework de Aplicaciones Web que hace posible crear Aplicaciones Web del lado del cliente en C# y HTML usando Web Assembly.

Las aplicaciones de Web Assembly se envían al navegador en un formato de instrucción binaria que puede operar a una velocidad cercana a nativa. Esto ha creado nuevas posibilidades para que lenguajes como C# se ejecuten dentro del navegador.

Crear un nuevo proyecto en Visual Studio

Para comenzar, abre la aplicación Microsoft Visual Studio y selecciona "Nuevo Proyecto" desde el menú Archivo. Luego, selecciona "Blazor Server App".

Creando un nuevo proyecto en Visual Studio

Ingresa un nombre de proyecto y selecciona una ruta de archivo. Luego, haz clic en el botón Create.

Eligiendo el nombre y la ubicación de la nueva Aplicación Blazor

Selecciona el marco .NET deseado (utilizaremos .NET 6.0 en este tutorial), como se muestra en la captura de pantalla a continuación:

Creando un Nuevo Proyecto en Visual Studio con el marco .NET 6.0

Microsoft Visual Studio ahora generará la estructura para esta aplicación Blazor.

A continuación, añade la biblioteca IronPDF a este nuevo proyecto.

3. Instalar la biblioteca IronPDF

La Biblioteca IronPDF se puede descargar e instalar de cuatro maneras:

• Usando el Administrador de Paquetes NuGet de Visual Studio
• Usando la Línea de Comandos de Visual Studio
• Descargando directamente desde el sitio web de NuGet
• Descargando directamente desde el sitio web de IronPDF

3.1 Uso del gestor de paquetes NuGet de Visual Studio

Visual Studio proporciona el Administrador de Paquetes NuGet para ayudar en la instalación directa de bibliotecas en proyectos. La captura de pantalla a continuación muestra cómo abrir el Gestor de Paquetes NuGet.

Accediendo al Administrador de Paquetes NuGet de Visual Studio

Usa el campo de búsqueda en la pestaña Examinar para buscar "IronPDF", como se muestra en la captura de pantalla a continuación:

Buscando la biblioteca IronPDF en la GUI del Administrador de Paquetes NuGet

En la imagen anterior, se muestra la lista de resultados de búsqueda relacionados. Selecciona las opciones requeridas para instalar el paquete en tu proyecto.

3.2 Uso de la línea de comandos de Visual Studio

En Visual Studio, ve a Herramientas > Administrador de Paquetes NuGet > Consola del Administrador de Paquetes

Ingresa la siguiente línea en la pestaña de la Consola del Administrador de Paquetes:

Install-Package IronPdf

El paquete ahora se descargará e instalará en el proyecto actual.

Instalando la biblioteca IronPDF usando la Consola del Administrador de Paquetes NuGet

3.3 Descarga directa desde el sitio web de NuGet

La tercera forma de instalar la biblioteca IronPDF es descargar el paquete NuGet directamente desde el sitio web.

Navega al sitio web de NuGet para IronPDF.

• Haz clic en la opción "Download Package" del menú en el lado derecho.
• Abre el paquete descargado en tu sistema de archivos. Se instalará automáticamente.
• Recarga la solución y empieza a usarla en tu proyecto.

3.4 Descarga directa desde el sitio web de IronPDF

Visita el sitio web de IronPDF para descargar el paquete IronPDF directamente.

Después de descargar, sigue estos pasos para añadir el paquete a tu proyecto:

• Haz clic derecho en el proyecto desde la ventana de la solución.
• Selecciona la opción "Agregar" > "Referencia" y luego navega a la ubicación de la biblioteca que descargaste anteriormente.
• Haz clic en OK para agregar la biblioteca como referencia.

4. Crear documentos PDF en la aplicación Blazor Server

La aplicación Blazor en este tutorial usará IronPDF para obtener el contenido HTML de una página web por su URL y convertirlo en un documento PDF.

Introduce el siguiente código fuente en el archivo .razor contenido en el proyecto.

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

El fragmento de código anterior usa dos métodos para generar documentos PDF desde HTML. El primero es el método RenderUrlAsPdf de IronPDF, que descarga el contenido HTML de una URL determinada y lo convierte a formato PDF.

El segundo método es el método estático JSRuntime.InvokeVoidAsync, que activa el motor JavaScript de un navegador para invocar una función JavaScript dentro del alcance de la página web que guarda el contenido PDF en un archivo en el sistema de archivos del cliente.

Esta función de JavaScript se incluye a continuación:

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

La función de JavaScript anterior recibe los datos Base64 de Blazor y los convierte en un blob antes de guardarlos en la ubicación del lado del cliente.

Alternativamente, el método SaveAs de la clase ChromePdfRenderer también se puede utilizar para guardar documentos PDF en el almacenamiento local del navegador.

5. Crear un documento PDF a partir de una cadena HTML

El siguiente fragmento de código muestra cómo convertir una cadena HTML en un documento.

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

El ejemplo anterior utiliza el método de instancia RenderHtmlAsPdf para transformar cualquier cadena de HTML en contenido PDF. Además, el método SaveAs se puede utilizar en los procedimientos descritos anteriormente para guardar este contenido en el ordenador del cliente.

La Aplicación de Generación de PDF Blazor creada en este tutorial

La captura de pantalla anterior muestra la Aplicación Web que se desarrolló en este tutorial. Hacer clic en el botón de Descarga activará el código C# para producir el contenido PDF, y una función de JavaScript para descargar el contenido PDF en el lado del cliente.

Conclusión

Este artículo demostró cómo desarrollar una Aplicación Web Blazor que utiliza la biblioteca PDF IronPDF para generar archivos PDF desde páginas web.

IronPDF no es de código abierto, sin embargo, una clave de prueba gratuita te permite usarlo en producción sin marcas de agua.