Introducción a ASP.NET Core

Artículo
09/14/2021
Tiempo de lectura: 6 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, así como en Windows.

Instalación de .NET Core

.NET Core 1.1 se instala automáticamente cuando se instala Visual Studio para Mac.

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

Abra Visual Studio para Mac. En la página principal, 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 > Aplicación web vacía de ASP.NET Core
.NET Core > Aplicación web de ASP.NET Core
.NET Core > API web de ASP.NET Core
Multiplataforma > Aplicación > Aplicación conectada

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 aplicación de ASP.NET Core, que debería parecerse 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:

Panel de solución con las dependencias

Program.cs

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

public static void Main(string[] args)
{
    var host = new WebHostBuilder()
        .UseKestrel()
        .UseContentRoot(Directory.GetCurrentDirectory())
        .UseIISIntegration()
        .UseStartup<Startup>()
        .Build();

    host.Run();
}

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:

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.
.UseStartup<Startup>(): especifica la clase Startup.

Los métodos de Compilación y ejecución compilan la interfaz IWebHost que hospedará la aplicación y la inician al escuchar las solicitudes HTTP entrantes.

Startup.cs

La clase Startup de la aplicación se especifica en el método UseStartup() en WebHostBuilder. 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
{
    public void ConfigureServices(IServiceCollection services)
    {
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
        loggerFactory.AddConsole();

        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 y verla en el explorador, pulse el botón Reproducir (el botón triangular) en la barra de herramientas:

Ejecutar la aplicación

Visual Studio para Mac usa un puerto aleatorio para iniciar el proyecto web. Para averiguar qué puerto es, abra la salida de la aplicación, que aparece en Vista > Paneles. 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

Abra su explorador preferido y escriba http://localhost:5000/. Reemplace 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. MVC consta de los siguientes elementos:

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 Overview of ASP.NET Core MVC (Introducción a MVC de ASP.NET Core).

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 Mac OS 10.11 (El Capitan) y versiones posteriores, 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 los cuatro pasos correctamente para asegurarse de que .NET Core está instalado 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 las guías que se indican a continuación:

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.