Inicio de la aplicación en ASP.NET Core

Por Rick Anderson

Las aplicaciones de ASP.NET Core creadas con las plantillas web contienen el código de inicio de la aplicación en el archivo Program.cs.

El siguiente código de inicio de la aplicación admite:

• Razor Pages
• Controladores MVC con vistas
• API web con controladores
• API mínimas

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseAuthorization();

app.MapGet("/hi", () => "Hello!");

app.MapDefaultControllerRoute();
app.MapRazorPages();

app.Run();

Las aplicaciones que usan EventSource pueden medir el tiempo de inicio para comprender y optimizar el rendimiento de inicio. El evento ServerReady de Microsoft.AspNetCore.Hosting representa el punto en el que el servidor está listo para responder a las solicitudes.

Para obtener más información sobre el inicio de la aplicación, consulte Información general de los conceptos básicos de ASP.NET Core.

Extensión del inicio con filtros de inicio

Use IStartupFilter:

• Para configurar el middleware al principio o al final de la canalización de middleware de una aplicación sin una llamada explícita a Use{Middleware}. Use IStartupFilter para agregar valores predeterminados al principio de la canalización sin registrar explícitamente el middleware predeterminado. IStartupFilter permite que otro componente llame a Use{Middleware} en nombre del creador de la aplicación.
• Para crear una canalización de métodos Configure. IStartupFilter.Configure puede configurar middleware para que se ejecute antes o después del middleware agregado por las bibliotecas.

IStartupFilter implementa Configure, que recibe y devuelve un elemento Action<IApplicationBuilder>. IApplicationBuilder define una clase para configurar la canalización de solicitudes de una aplicación. Para más información, vea Creación de una canalización de middleware con IApplicationBuilder.

Cada instancia de IStartupFilter puede agregar uno o más middleware en la canalización de solicitudes. Los filtros se invocan en el orden en que se agregaron al contenedor de servicios. Los filtros pueden agregar middleware antes o después de pasar el control al siguiente filtro, por lo que se anexan al principio o al final de la canalización de la aplicación.

En el ejemplo siguiente, se muestra cómo registrar un componente de middleware con IStartupFilter. El componente de middleware RequestSetOptionsMiddleware establece un valor de opciones de un parámetro de cadena de consulta:

public class RequestSetOptionsMiddleware
{
    private readonly RequestDelegate _next;

    public RequestSetOptionsMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // Test with https://localhost:5001/Privacy/?option=Hello
    public async Task Invoke(HttpContext httpContext)
    {
        var option = httpContext.Request.Query["option"];

        if (!string.IsNullOrWhiteSpace(option))
        {
            httpContext.Items["option"] = WebUtility.HtmlEncode(option);
        }

        await _next(httpContext);
    }
}

RequestSetOptionsMiddleware está configurado en las clase RequestSetOptionsStartupFilter:

namespace WebStartup.Middleware;
// <snippet1>
public class RequestSetOptionsStartupFilter : IStartupFilter
{
    public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next)
    {
        return builder =>
        {
            builder.UseMiddleware<RequestSetOptionsMiddleware>();
            next(builder);
        };
    }
}
// </snippet1>

IStartupFilter está registrado en Program.cs:

using WebStartup.Middleware;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddTransient<IStartupFilter,
                      RequestSetOptionsStartupFilter>();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Cuando se proporciona un parámetro de cadena de consulta para option, el middleware procesa la asignación del valor antes de que el middleware de ASP.NET Core represente la respuesta:

@page
@model PrivacyModel
@{
    ViewData["Title"] = "Privacy Policy";
}
<h1>@ViewData["Title"]</h1>

<p> Append query string ?option=hello</p>
Option String: @HttpContext.Items["option"];

El orden de ejecución de middleware se establece según el orden de registros de IStartupFilter:

• Varias implementaciones de IStartupFilter pueden interactuar con los mismos objetos. Si el orden es importante, ordene los registros de servicio de IStartupFilter para que coincidan con el orden en que se deben ejecutar los middleware.

• Las bibliotecas pueden agregar middleware con una o varias implementaciones de IStartupFilter que se ejecuten antes o después de otro middleware de aplicación registrado con IStartupFilter. Para invocar un middleware IStartupFilter antes de un middleware agregado por el elemento IStartupFilter de una biblioteca:

  • Coloque el registro del servicio antes de que la biblioteca se agregue al contenedor de servicios.
  • Para la invocación posterior, coloque el registro del servicio después de que se agregue la biblioteca.

Nota: No se puede extender la aplicación de ASP.NET Core al invalidar Configure. Para obtener más información, vea esta incidencia de GitHub.

Agregar opciones de configuración en el inicio desde un ensamblado externo

Una implementación de IHostingStartup permite agregar mejoras a una aplicación al iniciarla a partir de un ensamblado externo fuera del archivoProgram.cs de esta. Para obtener más información, consulte Uso de ensamblados de inicio de hospedaje en ASP.NET Core.

Startup, ConfigureServices y Configure

Para información sobre el uso de los métodos ConfigureServices y Configure con el modelo de hospedaje mínimo, consulte:

• Uso de Startup con el modelo de hospedaje mínimo
• La versión ASP.NET Core 5.0 de este artículo:
  • Método ConfigureServices
  • El método Configure