Introducción a ASP.NET Core

Artículo
09/14/2021
Tiempo de lectura: 7 minutos

Visual Studio para Mac facilita el desarrollo del servicio de la aplicación gracias a su compatibilidad con la plataforma de desarrollo web ASP.NET Core más reciente. ASP.NET Core se ejecuta en .NET Core, la evolución más reciente de .NET Framework y el tiempo de ejecución. Se ha ajustado para ofrecer un rendimiento rápido, se ha factorizado para admitir tamaños de instalación pequeños y se ha reinventado para ejecutarse en Linux y macOS, además de Windows.

Instalación de .NET Core

.NET Core 3.1 se instala automáticamente cuando se instala Visual Studio para Mac. Para obtener más información sobre las versiones de .NET Core que se admiten en Visual Studio para Mac, vea Compatibilidad de .NET Core.

Crear una aplicación de ASP.NET Core en Visual Studio para Mac

Abra Visual Studio para Mac. En la pantalla de inicio, seleccione Nuevo proyecto... .

Cuadro de diálogo Nuevo proyecto

Se mostrará el cuadro de diálogo Nuevo proyecto, que le permite seleccionar una plantilla para crear la aplicación.

Hay una serie de proyectos que le proporcionarán una plantilla predefinida para empezar a compilar la aplicación de ASP.NET Core. Estos son:

.NET Core > Vacío
.NET Core > API
.NET Core > Aplicación web
.NET Core > Aplicación web (Modelo-Vista-Controlador)
.NET Core > Aplicación de servidor Blazor
.NET Core > Aplicación Blazor WebAssembly

Opciones de proyecto de ASP.NET

Seleccione ASP.NET Core Empty Web Application (Aplicación web vacía de ASP.NET Core) y pulse Siguiente. Asígnele un nombre al proyecto y pulse Crear. Esto crea una nueva aplicación de ASP.NET Core. En el panel izquierdo de la ventana de la solución, expanda la segunda flecha y luego seleccione Startup.cs. Debería tener un aspecto similar a la imagen siguiente:

Vista de nuevo proyecto vacío de ASP.NET Core

La aplicación web vacía de ASP.NET Core crea una aplicación web con dos archivos predeterminados: Program.cs y Startup.cs, que se explican a continuación. También crea una carpeta Dependencias, que contiene las dependencias de paquetes NuGet del proyecto, como ASP.NET Core, .NET Core Framework y los destinos de MSBuild que compilan el proyecto:

Ventana de la solución con las dependencias

Program.cs

Abra e inspeccione el archivo Program.cs del proyecto. Observe que suceden varias cosas en el método Main, la entrada en la aplicación:

    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>();
    }

Una aplicación de ASP.NET Core crea un servidor web en su método principal, para lo que configura e inicia un host mediante una instancia de WebHostBuilder. Este generador proporciona métodos que permiten configurar el host. En la aplicación de plantilla se usan las configuraciones siguientes:

.UseStartup<Startup>(): especifica la clase Startup.

Aunque también se pueden agregar configuraciones adicionales, tales como:

UseKestrel: especifica que la aplicación usará el servidor Kestrel.
UseContentRoot(Directory.GetCurrentDirectory()): usa la carpeta raíz del proyecto web como raíz del contenido de la aplicación cuando la aplicación se inicia desde esta carpeta.
.UseIISIntegration(): especifica que la aplicación debería funcionar con IIS. Para usar IIS con ASP.NET Core, deben especificarse UseKestrel y UseIISIntegration.

Startup.cs

La clase Startup de la aplicación se especifica en el método UseStartup() en CreateWebHostBuilder. Es en esta clase donde especificará la canalización de control de solicitudes y donde configurará los servicios.

Abra e inspeccione el archivo Startup.cs del proyecto:

    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Hello World!");
            });
        }
    }

La clase Startup siempre debe cumplir las reglas siguientes:

Siempre debe ser pública.
Debe contener los dos métodos públicos ConfigureServices y Configure.

El método ConfigureServices define los servicios que usará la aplicación.

Configure permite crear la canalización de solicitudes mediante software intermedio. Se trata de componentes que se usan dentro de una canalización de aplicación de ASP.NET para controlar las solicitudes y las respuestas. La canalización HTTP está formada por una serie de delegados de solicitud, a los que se llama en secuencia. Cada delegado puede elegir controlar la solicitud o pasarla al delegado siguiente.

Puede configurar los delegados mediante los métodos Run, Map y Use en IApplicationBuilder, pero el método Run nunca llamará al delegado siguiente y siempre se debe usar al final de la canalización.

El método Configure de la plantilla predefinida está diseñado para realizar una serie de acciones. En primer lugar, configura una página de control de excepciones para su uso durante el desarrollo. Después, envía una respuesta a la página web que realiza la solicitud con un simple "Hello World".

Este sencillo proyecto Hello, World se puede ejecutar ahora sin necesidad de agregar más código. Para ejecutar la aplicación, puede seleccionar el explorador en el que desea ejecutar la aplicación mediante la lista desplegable situada a la derecha del botón de reproducción o simplemente presionar el botón Reproducir (el botón triangular) para usar el explorador predeterminado:

Ejecución del explorador

Visual Studio para Mac usa un puerto aleatorio para iniciar el proyecto web. Para averiguar qué puerto es, abra Salida de la aplicación, que aparece en el menú Vista > Otras ventanas. La salida debería parecerse a la que se muestra a continuación:

Salida de la aplicación en la que se muestra el puerto de escucha

Cuando el proyecto se está ejecutando, el explorador web predeterminado debe iniciarse y conectar con la dirección URL indicada en la salida de la aplicación. También puede abrir el explorador que prefiera y escribir http://localhost:5000/, lo que reemplaza 5000 por el puerto que Visual Studio genera en la salida de la aplicación. Debería ver el texto Hello World!:

explorador en el que se muestra el texto

Agregar un controlador

Las aplicaciones de ASP.NET Core usan el modelo de diseño Controlador de vista de modelos (MVC) para proporcionar una separación lógica de las responsabilidades para cada elemento de la aplicación. El modelo de diseño de MVC consta de los conceptos siguientes:

Model: clase que representa los datos de la aplicación.
Vista: muestra la interfaz de usuario de la aplicación (que suelen ser los datos del modelo).
Controller: clase que controla las solicitudes del explorador y responde a la entrada y la interacción del usuario.

Para obtener más información sobre el uso de MVC, vea la guía Información general de ASP.NET Core MVC.

Para agregar un controlador, haga lo siguiente:

Haga clic con el botón derecho en el nombre del proyecto y seleccione Agregar > New Files (Nuevos archivos). Seleccione General > Clase vacía y escriba un nombre de controlador:

Agregue el código siguiente al nuevo controlador:

using System;
using Microsoft.AspNetCore.Mvc;
using System.Text.Encodings.Web;

namespace Hello_ASP
{
    public class HelloWorldController : Controller
    {
        //
        // GET: /HelloWorld/

        public string Index()
        {
            return "This is my default action...";
        }

    }
}

Agregue la dependencia Microsoft.AspNetCore.Mvc al proyecto. Para ello, haga clic con el botón derecho en la carpeta Dependencia y seleccione Agregar paquete…
Use el cuadro de búsqueda para buscar la biblioteca de NuGet para Microsoft.AspNetCore.Mvc y seleccione Agregar paquete. Es posible que tarde unos minutos en instalarse y que se le pida que acepte varias licencias para las dependencias necesarias:
En la clase Startup, quite la expresión lambda app.Run y establezca la lógica de enrutamiento de dirección URL usada por MVC para determinar qué código debe invocar para lo siguiente:
```
app.UseMvc(routes =>
{
    routes.MapRoute(
    name: "default",
    template: "{controller=HelloWorld}/{action=Index}/{id?}");
});
```
Asegúrese de quitar la expresión lambda app.Run, ya que invalidará la lógica de enrutamiento.

MVC usa el formato siguiente para determinar qué código se ejecuta:

/[Controller]/[ActionName]/[Parameters]

Al agregar el fragmento de código anterior, le indica a la aplicación que use como valor predeterminado el controlador HelloWorld y el método de acción Index.
Agregue la llamada services.AddMvc(); al método ConfigureServices, como se muestra a continuación:
```
public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc();
}
```
También puede pasar información de parámetros desde la dirección URL al controlador.

Agregue otro método a HelloWorldController, como se muestra a continuación:

public string Xamarin(string name)
{
    return HtmlEncoder.Default.Encode($"Hello {name}, welcome to Visual Studio for Mac");
}

Si ejecuta ahora la aplicación, debería abrir automáticamente el explorador:
Intente ir a http://localhost:xxxx/HelloWorld/Xamarin?name=Amy (reemplace xxxx por el puerto correcto). Debería aparecer lo siguiente:

Solución de problemas

Si necesita instalar .NET Core manualmente en macOS 10.12 (Sierra) y superior, haga lo siguiente:

Antes de iniciar la instalación de .NET Core, asegúrese de que ha instalado la versión estable más reciente de todas las actualizaciones del sistema operativo. Para comprobarlo, vaya a la aplicación del App Store y seleccione la pestaña Actualizaciones.
Siga los pasos indicados en el sitio de .NET Core.

Complete todos los pasos correctamente para asegurarse de que .NET Core se instala correctamente.

Resumen

En esta guía, se le ha proporcionado una introducción a ASP.NET Core. Describe qué es, cuándo se usa y cómo se usa en Visual Studio para Mac. Para obtener más información sobre los pasos siguientes, vea estas guías:

Documentos sobre ASP.NET Core.
Creating Backend Services for Native Mobile Applications (Crear servicios back-end para aplicaciones móviles nativas), donde se muestra cómo compilar un servicio REST mediante ASP.NET Core para una aplicación de Xamarin.Forms.
Laboratorio práctico de ASP.NET Core.