Spuštění aplikace v ASP.NET Core

Autor: Rick Anderson

Aplikace ASP.NET Core vytvořené pomocí webových šablon obsahují spouštěcí kód aplikace v souboru Program.cs.

Následující spouštěcí kód aplikace podporuje:

• Razor Pages
• Kontrolery MVC se zobrazeními
• Webové rozhraní API s kontrolery
• Minimální rozhraní API

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

Aplikace využívající EventSource můžou měřit čas spuštění, aby porozuměly výkonu při spuštění a optimalizovaly ho. Událost ServerReady v Microsoft.AspNetCore.Hosting představuje bod, ve kterém je server připraven reagovat na požadavky.

Další informace o spouštění aplikací najdete v přehledu ASP.NET Core základních informací.

Rozšíření spouštění pomocí spouštěcích filtrů

IStartupFilter použijte:

• Konfigurace middlewaru na začátku nebo na konci kanálu middlewaru aplikace bez explicitního volání Use{Middleware}. Slouží IStartupFilter k přidání výchozích hodnot na začátek kanálu bez explicitní registrace výchozího middlewaru. IStartupFilter umožňuje za autora aplikace volat Use{Middleware} jinou komponentu.
• Vytvoření kanálu Configure metod. IStartupFilter.Configure může nastavit middleware, který se má spustit před nebo po middlewaru přidaného knihovnami.

IStartupFilter implementuje Configure, který přijme a vrátí Action<IApplicationBuilder>. Definuje IApplicationBuilder třídu pro konfiguraci kanálu požadavků aplikace. Další informace najdete v tématu Vytvoření kanálu middlewaru pomocí nástroje IApplicationBuilder.

Každý z nich IStartupFilter může v kanálu požadavků přidat jeden nebo více middlewarů. Filtry jsou vyvolány v pořadí, v jakém byly přidány do kontejneru služby. Filtry můžou přidat middleware před nebo po předání ovládacího prvku do dalšího filtru, a proto se připojují na začátek nebo konec kanálu aplikace.

Následující příklad ukazuje, jak zaregistrovat middleware pomocí IStartupFilternástroje . Middleware RequestSetOptionsMiddleware nastaví hodnotu možností z parametru řetězce dotazu:

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

Je RequestSetOptionsMiddleware nakonfigurovaný ve RequestSetOptionsStartupFilter třídě:

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

Je IStartupFilter zaregistrovaný v 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();

Pokud je zadaný parametr řetězce dotazu prooption, middleware zpracuje přiřazení hodnoty předtím, než ASP.NET Core middleware vykreslí odpověď:

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

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

Pořadí spuštění middlewaru se nastavuje podle pořadí IStartupFilter registrací:

• Více IStartupFilter implementací může interagovat se stejnými objekty. Pokud je řazení důležité, seřiděte registrace IStartupFilter služby tak, aby odpovídaly pořadí, ve které by měly middlewary běžet.

• Knihovny můžou přidávat middleware s jednou nebo více IStartupFilter implementacemi, které běží před nebo po jiném middlewaru aplikace zaregistrovaného ve službě IStartupFilter. Vyvolání middlewaru IStartupFilter před middlewarem přidaným knihovnou IStartupFilter:

  • Umístěte registraci služby před přidání knihovny do kontejneru služby.
  • Pokud chcete vyvolat později, umístěte registraci služby po přidání knihovny.

Poznámka: Aplikaci ASP.NET Core nemůžete rozšířit, když přepíšete Configure. Další informace najdete v tomto problému na GitHubu.

Přidání konfigurace při spuštění z externího sestavení

Implementace IHostingStartup umožňuje přidat vylepšení aplikace při spuštění z externího sestavení mimo soubor aplikace Program.cs . Další informace viz Použití hostujících spouštěcích sestavení v ASP.NET Core.

Spuštění, Konfiguraceslužeb a Konfigurace

Informace o použití ConfigureServices metod a Configure s minimálním modelem hostování najdete tady:

• Použití spouštěcího modelu s minimálním modelem hostování
• Verze ASP.NET Core 5.0 tohoto článku:
  • Metoda ConfigureServices
  • Metoda Configure