Inicialização de aplicativo no ASP.NET Core

Por Rick Anderson

Aplicativos ASP.NET Core criados com modelos Web contêm o código de inicialização do aplicativo no arquivo Program.cs.

Para obter diretrizes de inicialização do Blazor, que adicionam ou se sobrepõem às diretrizes neste artigo, consulte Inicialização do ASP.NET Core Blazor.

O seguinte código de inicialização do aplicativo dá suporte a:

• Razor Pages
• Controladores MVC com exibições
• API Web com controladores
• APIs 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();

Os aplicativos que usam EventSource podem medir o tempo de inicialização para entender e otimizar o desempenho da inicialização. O evento ServerReady em Microsoft.AspNetCore.Hosting representa o ponto em que o servidor está pronto para responder às solicitações.

Para obter mais informações sobre a inicialização do aplicativo, consulte visão geral dos conceitos básicos do ASP.NET Core.

Estender a inicialização com filtros de inicialização

Use IStartupFilter:

• Para configurar o middleware no início ou no final do pipeline do middleware de um aplicativo sem uma chamada explícita para Use{Middleware}. Use IStartupFilter para adicionar padrões ao início do pipeline sem registrar explicitamente o middleware padrão. IStartupFilter permite que um componente diferente chame Use{Middleware} em nome do autor do aplicativo.
• Para criar um pipeline de métodos Configure. IStartupFilter.Configure pode definir um middleware para ser executado antes ou depois do middleware adicionado pelas bibliotecas.

IStartupFilter implementa Configure, que recebe e retorna um Action<IApplicationBuilder>. Um IApplicationBuilder define uma classe para configurar o pipeline de solicitação do aplicativo. Para obter mais informações, confira Criar um pipeline de middleware com o IApplicationBuilder.

Cada IStartupFilter pode adicionar um ou mais middlewares no pipeline de solicitação. Os filtros são invocados na ordem em que foram adicionados ao contêiner de serviço. Filtros podem adicionar middleware antes ou depois de passar o controle para o filtro seguinte, de modo que eles são acrescentados ao início ou no final do pipeline de aplicativo.

O exemplo a seguir demonstra como registrar um middleware com IStartupFilter. O middleware RequestSetOptionsMiddleware define um valor de opção de um parâmetro de cadeia de caracteres 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);
    }
}

O RequestSetOptionsMiddleware é configurado na classe RequestSetOptionsStartupFilter:

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

O IStartupFilter está registrado em 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();

Quando um parâmetro de cadeia de caracteres de consulta para option é fornecido, o middleware processa a atribuição de valor antes que o middleware do ASP.NET Core renderize a resposta:

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

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

A ordem de execução do middleware é definida pela ordem dos registros IStartupFilter:

• Várias implementações de IStartupFilter podem interagir com os mesmos objetos. Se a ordem for importante, ordene seus registros de serviço IStartupFilter para corresponder à ordem em que os middlewares devem ser executados.

• Bibliotecas podem adicionar middleware com uma ou mais implementações de IStartupFilter que são executadas antes ou depois de outro middleware de aplicativo registrado com IStartupFilter. Para invocar um middleware IStartupFilter antes de um middleware adicionado pelo IStartupFilter de uma biblioteca:

  • Posicione o registro do serviço antes que a biblioteca seja adicionada ao contêiner de serviço.
  • Para invocá-lo posteriormente, posicione o registro do serviço após a biblioteca ser adicionada.

Observação: você não pode estender o aplicativo ASP.NET Core ao substituir Configure. Para obter mais informações, consulte este tópico do GitHub.

Adicionar configuração na inicialização usando um assembly externo

Uma implementação IHostingStartup permite adicionar melhorias a um aplicativo durante a inicialização a partir de um assembly externo fora do arquivo Program.cs do aplicativo. Para obter mais informações, confira Usar assemblies de inicialização de hospedagem no ASP.NET Core.

Startup, ConfigureServices e Configure

Para obter informações sobre como usar os métodos ConfigureServices e Configure com o modelo de hospedagem mínima, confira:

• Usar Startup com o modelo de hospedagem mínima
• A versão do ASP.NET Core 5.0 deste artigo:
  • O método ConfigureServices
  • O método Configure