Avvio dell'app in ASP.NET Core

Di Rick Anderson

Le app ASP.NET Core create con i modelli Web contengono il codice di avvio dell'applicazione nel file Program.cs.

Per Blazor indicazioni sull'avvio, che aggiunge o sostituisce le linee guida in questo articolo, vedere ASP.NET avvio di CoreBlazor.

Il codice di avvio dell'app seguente supporta:

• Razor Pages
• Controller MVC con visualizzazioni
• API Web con controller
• API minime

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();

Le app che usano EventSource possono misurare il tempo di avvio per comprendere e ottimizzare le prestazioni di avvio. L'evento ServerReady in Microsoft.AspNetCore.Hosting rappresenta il punto in cui il server è pronto per rispondere alle richieste.

Per altre informazioni sull'avvio dell'applicazione, vedere ASP.NET Panoramica dei concetti fondamentali di Base.

Estendere l'avvio con filtri di avvio

Usare IStartupFilter:

• Per configurare il middleware all'inizio o alla fine della pipeline middleware di un'app senza una chiamata esplicita a Use{Middleware}. Usare IStartupFilter per aggiungere valori predefiniti all'inizio della pipeline senza registrare in modo esplicito il middleware predefinito. IStartupFilter consente a un componente diverso di chiamare Use{Middleware} per conto dell'autore dell'app.
• Per creare una pipeline di Configure metodi. IStartupFilter.Configure può impostare un middleware da eseguire prima o dopo l'aggiunta del middleware dalle librerie.

IStartupFilter implementa Configure, che riceve e restituisce un Action<IApplicationBuilder>. IApplicationBuilder definisce una classe per configurare la pipeline delle richieste di un'app. Per altre informazioni, vedere Creare una pipeline middleware con IApplicationBuilder.

Ogni IStartupFilter può aggiungere uno o più middleware nella pipeline delle richieste. I filtri vengono richiamati nell'ordine in cui sono stati aggiunti al contenitore di servizi. Poiché i filtri possono aggiungere il middleware prima o dopo il passaggio del controllo al filtro successivo, i filtri vengono aggiunti all'inizio o alla fine della pipeline dell'app.

L'esempio seguente dimostra come registrare un middleware con IStartupFilter. Il middleware RequestSetOptionsMiddleware imposta un valore di opzioni da un parametro di stringa di query:

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 è configurato nella 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>

l'oggetto IStartupFilter è registrato in 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 viene specificato un parametro della stringa di query per option , il middleware elabora l'assegnazione del valore prima che il middleware ASP.NET Core esegua il rendering della risposta:

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

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

L'ordine di esecuzione del middleware viene impostato in base all'ordine delle registrazioni IStartupFilter:

• Più implementazioni IStartupFilter possono interagire con gli stessi oggetti. Se l'ordinamento è un fattore importante, ordinare le registrazioni di servizio IStartupFilter in un ordine corrispondente a quello di esecuzione dei relativi middleware.

• Le librerie possono aggiungere middleware con una o più implementazioni IStartupFilter che viene eseguito prima o dopo altri middleware dell'app registrati con IStartupFilter. Per richiamare un middleware IStartupFilter prima che un middleware venga aggiunto da IStartupFilter di una libreria:

  • Posizionare la registrazione del servizio prima che la libreria venga aggiunta al contenitore di servizi.
  • Per richiamarlo in un secondo momento, posizionare la registrazione dei servizi dopo l'aggiunta della libreria.

Nota: non è possibile estendere l'app ASP.NET Core quando si esegue l'override Configuredi . Per altre informazioni, vedere questo problema di GitHub.

Aggiungere elementi di configurazione all'avvio da un assembly esterno

Un'implementazione IHostingStartup consente di aggiungere miglioramenti a un'app all'avvio da un assembly esterno all'esterno del file dell'app Program.cs . Per altre informazioni, vedere Usare assembly di avvio dell'hosting in ASP.NET Core.

Avvio, configurazioneservizi e configurazione

Per informazioni sull'uso dei ConfigureServices metodi e Configure con il modello di hosting minimo, vedere:

• Usare Startup con il modello di hosting minimo
• La versione ASP.NET Core 5.0 di questo articolo:
  • Metodo ConfigureServices
  • Metodo Configure