.NET Aspire se destaca como un marco de trabajo decisivo, listo para la nube, diseñado para construir aplicaciones distribuidas, observables y listas para producción. Entregado a través de un conjunto de paquetes NuGet, Aspire aborda de manera eficiente diversas consideraciones de descubrimiento de servicios nativos en la nube y busca proporcionar patrones de configuración consistentes. En el ámbito de las aplicaciones nativas de la nube de .NET, la norma involucra componentes más pequeños e interconectados o microservicios en aplicaciones distribuidas, alejándose de la estructura de código monolítico tradicional. Estas aplicaciones suelen confiar en numerosos servicios como bases de datos, sistemas de mensajería, recursos en la nube y almacenamiento en caché.

Las aplicaciones distribuidas, en este contexto, aprovechan los recursos computacionales que abarcan múltiples nodos, como contenedores que operan en hosts diversos. La comunicación efectiva a través de los límites de la red es esencial para que estos nodos colaboren en la entrega de respuestas a los usuarios finales. Específicamente, una aplicación distribuida nativa de la nube es una categoría distinta dentro de las aplicaciones distribuidas, aprovechando la escalabilidad, resiliencia y manejabilidad inherentes en las infraestructuras de aplicaciones nativas de la nube.

En este artículo, discutiremos los componentes de .NET Aspire para crear una aplicación web. Además, utilizaremos la biblioteca IronPDF para crear y descargar archivos PDF en el componente del proyecto Aspire .NET.

1. Introducción a .NET Aspire

La aplicación .NET Aspire se presenta como una iniciativa con propósito dirigido a mejorar la experiencia de desarrollo para aplicaciones nativas de la nube en .NET dentro del ecosistema .NET. Introduce una suite cohesiva y con opinión de herramientas y patrones de diseño elaborados para facilitar la construcción y operación sin problemas de aplicaciones distribuidas. Los objetivos principales de la aplicación de inicio de .NET Aspire incluyen:

1. Orquestación: La orquestación de .NET Aspire ofrece capacidades robustas para orquestar aplicaciones multiproyecto y sus complejas dependencias. Esta funcionalidad asegura la ejecución suave y la conectividad sin fisuras entre diversos componentes de los proyectos .NET.
2. Componentes: Los componentes ofrecidos por la orquestación de .NET Aspire están encapsulados dentro de paquetes NuGet, representando servicios ampliamente utilizados como el recurso de contenedor local de Redis o Postgres. Estos componentes están caracterizados por interfaces estandarizadas, garantizando una integración consistente y sin fisuras con su aplicación. Al aprovechar estos componentes preempaquetados, los desarrolladores pueden agilizar el proceso de desarrollo y mantener un mayor nivel de interoperabilidad y aplicaciones nativas de la nube configurables utilizando plantillas de proyecto de .NET Aspire.
3. Herramientas: Las plantillas de inicio de .NET Aspire incorporan un conjunto integral de herramientas diseñadas para agilizar el flujo de trabajo de desarrollo. Las experiencias de plantillas de proyecto y herramientas están integradas cuidadosamente en Visual Studio y la CLI de .NET, empoderando a los desarrolladores para crear e interactuar con aplicaciones .NET Aspire sin esfuerzo. Este marco inclusivo de herramientas mejora la productividad y proporciona un entorno cohesivo para desarrollar y gestionar configuraciones de aplicaciones .NET Aspire y plantillas de proyectos.

En esencia, .NET Aspire sirve como una solución holística, abordando aspectos clave de preocupaciones específicas de la nube como orquestación, integración de componentes y herramientas, todo destinado a elevar la eficiencia y consistencia de construir y desplegar aplicaciones nativas de la nube en .NET.

2. Introducción a .NET Aspire

Antes de involucrarse con .NET Aspire, asegúrese de que los siguientes componentes estén instalados localmente:

1. .NET 8.0: Asegúrese de tener .NET 8.0 instalado en su sistema.
2. Entorno de trabajo ASP.NET: Adquiere el entorno de trabajo ASP.NET ya sea utilizando el instalador de VS o ejecutando el comando dotnet workload install aspire.
3. Entorno de Desarrollo Integrado (IDE) o Editor de Código: Antes debe estar instalado Visual Studio 2022 en el sistema.

Si todos estos requisitos se cumplen, está listo para comenzar con el desarrollo de sus primeros componentes de .NET Aspire que manejan aplicaciones.

3. Crear un nuevo proyecto .NET Aspire

Para crear aplicaciones .NET Aspire, siga los siguientes pasos.

1. Abra Visual Studio y haga clic en Crear un nuevo proyecto.
2. Aparecerá una nueva ventana. En esta nueva ventana, busque Aspire en la barra de búsqueda.
3. Aparecerá una lista a continuación, de esa lista seleccione el proyecto de inicio de Aspire apphost y las referencias de paquetes y haga clic en Siguiente.
4. Aparecerá una nueva ventana. En esta nueva ventana escriba el nombre del proyecto y haga clic en Siguiente.
5. En esta ventana seleccione el marco de trabajo objetivo y haga clic en el botón Crear.

La aplicación .NET Aspire se creará en unos segundos, y estará listo para comenzar con el desarrollo y personalización.

4. Ejecutar y probar la aplicación .NET Aspire

Una vez que el proyecto está creado simplemente haga clic en el botón Ejecutar, tomará algún tiempo crear una compilación y después de eso, abrirá una página web de nuestra aplicación web Aspire en la página de inicio.

Esta página de inicio contendrá nuestra pila de aplicaciones nativas de la nube .NET Aspire para construir aplicaciones de inicio .NET Aspire listas para producción y observables.

Ahora haga clic en los enlaces para interactuar con .NET. Por ahora haga clic en el proyecto web frontend de .NET Aspire y las referencias de paquetes. Abrirá la nueva página web con un nombre de puerto diferente.

5. Introducing IronPDF C#

La documentación de IronPDF lo describe como una biblioteca C# poderosa y versátil que empodera a los desarrolladores para integrar sin esfuerzo capacidades avanzadas de generación y manipulación de PDF en sus aplicaciones. Desarrollada por Iron Software, esta biblioteca rica en funciones ofrece un conjunto completo de herramientas para crear, modificar y renderizar documentos PDF directamente dentro de aplicaciones C#.

Con IronPDF, los desarrolladores pueden generar sin problemas PDFs a partir de varias fuentes, como HTML, imágenes y documentos existentes, mientras mantienen un control preciso sobre el formato y el diseño. Ya sea creando informes dinámicos, convirtiendo contenido HTML a PDF o agregando anotaciones a documentos existentes, IronPDF agiliza el proceso de manejo de PDFs, convirtiéndolo en un activo invaluable para los desarrolladores C# que buscan una solución confiable y eficiente para sus necesidades de gestión de documentos.

5.1. Instalación de IronPDF

Para instalar IronPDF sin problemas, aproveche el Administrador de Paquetes NuGet dentro de Visual Studio. El paquete designado para la instalación se titula IronPDF. Simplemente copie y pegue el siguiente comando en la Consola del Administrador de Paquetes y presione enter:

Install-Package IronPdf

5.2. Integración de IronPDF con Aspire Component

Integrar IronPDF con el componente Aspire es lo mismo que integrarlo con la aplicación web de Blazor porque los componentes de Aspire pueden usar la aplicación de Blazor como un componente. En este ejemplo de código, cambiaremos el código de la Página de Contador para crear y descargar un archivo PDF.

Abre el archivo counter.razor y reemplaza el código con el siguiente código.

@page "/PrintPDF"
@rendermode InteractiveServer
@using IronPdf
<PageTitle>Print PDF</PageTitle>
<h1>IronPDF</h1>
<p role="status">Click on the button below to create and download the PDF file </p>
<button class="btn btn-primary" @onclick="IncrementCount">Print</button>
@code {
    private int currentCount = 0;

    /// <summary>
    /// Handles the click event of the "Print" button.
    /// This function will generate a PDF from an HTML string and prompt the user to download it.
    /// </summary>
    private void IncrementCount()
    {
        var renderer = new ChromePdfRenderer();
        // Create a PDF from an HTML string using C#
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        // Export to a file using JavaScript Interop to initiate download
        JSRuntime.InvokeVoidAsync("saveAsFile", "output.pdf", Convert.ToBase64String(pdf.Stream.ToArray()));
    }
}

@page "/PrintPDF"
@rendermode InteractiveServer
@using IronPdf
<PageTitle>Print PDF</PageTitle>
<h1>IronPDF</h1>
<p role="status">Click on the button below to create and download the PDF file </p>
<button class="btn btn-primary" @onclick="IncrementCount">Print</button>
@code {
    private int currentCount = 0;

    /// <summary>
    /// Handles the click event of the "Print" button.
    /// This function will generate a PDF from an HTML string and prompt the user to download it.
    /// </summary>
    private void IncrementCount()
    {
        var renderer = new ChromePdfRenderer();
        // Create a PDF from an HTML string using C#
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");
        // Export to a file using JavaScript Interop to initiate download
        JSRuntime.InvokeVoidAsync("saveAsFile", "output.pdf", Convert.ToBase64String(pdf.Stream.ToArray()));
    }
}

'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: @page "/PrintPDF" @rendermode InteractiveServer using IronPdf <PageTitle> Print PDF</PageTitle> <h1> IronPDF</h1> <p role="status"> Click on the button below to create and download the PDF file </p> <button class="btn btn-primary" onclick="IncrementCount"> Print</button> @code
"btn btn-primary" onclick="IncrementCount"> Print</button> code
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: Friend @page "/PrintPDF" @rendermode InteractiveServer using IronPdf <PageTitle> Print PDF</PageTitle> <h1> IronPDF</h1> <p role="status"> Click on the button below to create and download the PDF file </p> <button Class="btn btn-primary" onclick
"status"> Click on the button below [to] create [and] download the PDF file </p> <button Class="btn btn-primary" onclick
Private Private Friend page "/PrintPDF" rendermode InteractiveServer [using] IronPdf (Of PageTitle) Print PDF</PageTitle> (Of h1) IronPDF</h1> <p role="status"> Click on the button below [to] create [and] download the PDF file </p> <button Class
	Private currentCount As Integer = 0

	''' <summary>
	''' Handles the click event of the "Print" button.
	''' This function will generate a PDF from an HTML string and prompt the user to download it.
	''' </summary>
	Private Sub IncrementCount()
		Dim renderer = New ChromePdfRenderer()
		' Create a PDF from an HTML string using C#
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
		' Export to a file using JavaScript Interop to initiate download
		JSRuntime.InvokeVoidAsync("saveAsFile", "output.pdf", Convert.ToBase64String(pdf.Stream.ToArray()))
	End Sub
End Class

'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: @page "/PrintPDF" @rendermode InteractiveServer using IronPdf <PageTitle> Print PDF</PageTitle> <h1> IronPDF</h1> <p role="status"> Click on the button below to create and download the PDF file </p> <button class="btn btn-primary" onclick="IncrementCount"> Print</button> @code
"btn btn-primary" onclick="IncrementCount"> Print</button> code
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: Friend @page "/PrintPDF" @rendermode InteractiveServer using IronPdf <PageTitle> Print PDF</PageTitle> <h1> IronPDF</h1> <p role="status"> Click on the button below to create and download the PDF file </p> <button Class="btn btn-primary" onclick
"status"> Click on the button below [to] create [and] download the PDF file </p> <button Class="btn btn-primary" onclick
Private Private Friend page "/PrintPDF" rendermode InteractiveServer [using] IronPdf (Of PageTitle) Print PDF</PageTitle> (Of h1) IronPDF</h1> <p role="status"> Click on the button below [to] create [and] download the PDF file </p> <button Class
	Private currentCount As Integer = 0

	''' <summary>
	''' Handles the click event of the "Print" button.
	''' This function will generate a PDF from an HTML string and prompt the user to download it.
	''' </summary>
	Private Sub IncrementCount()
		Dim renderer = New ChromePdfRenderer()
		' Create a PDF from an HTML string using C#
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")
		' Export to a file using JavaScript Interop to initiate download
		JSRuntime.InvokeVoidAsync("saveAsFile", "output.pdf", Convert.ToBase64String(pdf.Stream.ToArray()))
	End Sub
End Class

Después de eso escriba el código JavaScript para descargar el archivo PDF. Escriba este código en la etiqueta de script en el ámbito de la etiqueta de cuerpo de HTML. Código para agregar a su proyecto:

<script type="text/javascript">
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            //Download document in 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">
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            //Download document in 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>

Simplemente ejecute el código después de eso se verá algo como la imagen de abajo.

Para crear y descargar un archivo PDF haga clic en el botón Imprimir. Creará y descargará el archivo PDF llamado output.pdf.

6. Conclusión

.NET Aspire surge como un marco de trabajo clave, diseñado para desarrollar aplicaciones robustas, observables y distribuidas en el entorno de la nube. Al proporcionar un conjunto cohesivo de herramientas y patrones de diseño, .NET Aspire simplifica las complejidades asociadas con la construcción de aplicaciones nativas de la nube, ofreciendo una orquestación sin fisuras, integración de componentes y un marco de herramientas fácil de usar. Con un enfoque en escalabilidad, resiliencia y manejabilidad, .NET Aspire se alinea con el cambio de paradigma hacia microservicios y arquitecturas distribuidas.

A medida que los desarrolladores emprenden su viaje con .NET Aspire, obtienen acceso a un conjunto completo de características, desde aplicaciones multiproyecto orquestadas hasta componentes estandarizados encapsulados en paquetes NuGet. Siguiendo los requisitos previos y los pasos sencillos delineados en la guía, los desarrolladores pueden crear, ejecutar y probar aplicaciones .NET Aspire sin esfuerzo.

Además, la integración de IronPDF en los componentes Aspire muestra la extensibilidad y versatilidad del marco de trabajo, permitiendo a los desarrolladores incorporar de manera fluida capacidades avanzadas de generación y manipulación de PDF en sus aplicaciones nativas de la nube. En general, .NET Aspire, con sus objetivos bien definidos y su enfoque fácil de usar, se posiciona como un activo valioso para los desarrolladores que buscan una solución eficiente y consistente para construir y desplegar aplicaciones nativas de la nube dentro del ecosistema .NET.

Para un tutorial completo sobre el uso de IronPDF con Blazor en aplicaciones web, visite el tutorial del blog de IronPDF. Para obtener una prueba gratuita de IronPDF, visite la página de licencias de IronPDF para obtener su licencia de prueba gratuita.