Applikationsstart för ASP.NET Core

Av Rick Anderson

ASP.NET Core-appar som skapats med webbmallarna innehåller programmets startkod i filen Program.cs.

Vägledning för Blazor start, som lägger till eller ersätter vägledningen i den här artikeln, finns i ASP.NET Core Blazor start.

Följande appstartkod stöder flera apptyper:

• Blazor Web Apps
• Razor sidor
• MVC-styrenheter med vyer
• webb-API med kontrollanter
• minimala API:er

using WebAll.Components;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();
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.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

app.UseAntiforgery();

app.Run();

Appar som använder EventSource kan mäta starttiden för att förstå och optimera startprestanda. Den ServerReady händelsen i Microsoft.AspNetCore.Hosting representerar den punkt där servern är redo att svara på begäranden.

Utöka start med startfilter

Använd IStartupFilter:

• Konfigurera mellanprogram i början eller slutet av en apps pipeline för mellanprogram utan ett explicit anrop till Use{Middleware}. Använd IStartupFilter för att lägga till standardvärden i början av pipelinen utan att uttryckligen registrera standardmellanprogrammet. IStartupFilter tillåter att en annan komponent anropar Use{Middleware} för appförfattarens räkning.
• Skapa en pipeline av Configure-metoder. IStartupFilter.Configure kan ange att ett mellanprogram ska köras före eller efter mellanprogram som lagts till av bibliotek.

En IStartupFilter implementering implementerar Configure, som tar emot och returnerar en Action<IApplicationBuilder>. En IApplicationBuilder definierar en klass för att konfigurera en applikations begärande-pipeline. Mer information finns i Skapa en pipeline för mellanprogram med IApplicationBuilder.

Varje IStartupFilter implementering kan lägga till ett eller flera mellanprogram i pipelinen för begäranden. Filtren anropas i den ordning de lades till i tjänstcontainern. Filter kan lägga till mellanprogram före eller efter att kontrollen har överförts till nästa filter, vilket gör att de läggs till i början eller slutet av apppipelinen.

I följande exempel visas hur du registrerar ett mellanprogram med IStartupFilter. RequestSetOptionsMiddleware mellanprogram anger ett alternativvärde från en frågesträngsparameter:

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 har konfigurerats i klassen RequestSetOptionsStartupFilter:

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

Implementeringen IStartupFilter registreras i 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();

När en frågesträngsparameter för option tillhandahålls bearbetar mellanprogrammet värdetilldelningen innan ASP.NET Core-mellanprogrammet återger svaret:

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

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

Körningsordningen för mellanmjukvara anges enligt ordningen av IStartupFilter-registreringar.

• Flera IStartupFilter implementeringar kan interagera med samma objekt. Om det är viktigt med rätt ordning, beställer du registreringarna av deras IStartupFilter-tjänster så att de överensstämmer med den ordning i vilken deras mellanprogram ska köras.

• Bibliotek kan lägga till mellanprogram med en eller flera IStartupFilter implementeringar som körs före eller efter andra appmellanprogram som registrerats med IStartupFilter. Så här anropar du ett IStartupFilter mellanprogram innan ett mellanprogram som läggs till av ett biblioteks IStartupFilter:

  • Placera tjänstregistreringen innan biblioteket läggs till i tjänstcontainern.
  • Om du vill anropa efteråt placerar du tjänstregistreringen efter att biblioteket har lagts till.

Du kan inte utöka ASP.NET Core-appen när du åsidosätter Configure. Mer information finns i det här GitHub-ärendet.

Lägga till konfiguration vid start från en extern sammansättning

Med en IHostingStartup implementering kan du lägga till förbättringar i en app vid start från en extern sammansättning utanför appens Program.cs-fil. Mer information finns i Använda värdstartssammansättningar i ASP.NET Core.

Start, ConfigureServices och Konfigurera

Information om hur du använder metoderna ConfigureServices och Configure med den minimala värdmodellen finns i:

• Använd start med den minimala värdmodellen
• ASP.NET Core 5.0-versionen av den här artikeln:
  • Metoden ConfigureServices
  • Konfigureringsmetoden