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

Autor: Rick Anderson

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

Pokyny ke spuštěníBlazor, které se přidávají nebo nahrazují pokyny v tomto článku, najdete v tématu ASP.NET Core Blazor startup.

Následující spouštěcí kód aplikace podporuje několik typů aplikací:

• Blazor Web AppS
• Razor Stránky
• Kontrolery MVC se zobrazeními
• Webové rozhraní API s kontrolery
• Minimální rozhraní API

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

Aplikace, které používají EventSource , můžou měřit dobu 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, kdy je server připravený reagovat na požadavky.

Rozšíření procesu spuštění pomocí filtrů spuštění

IStartupFilter použijte:

• Konfigurace middlewaru na začátku nebo na konci sekvence middlewaru v aplikaci bez explicitního volání Use{Middleware}. Použijte IStartupFilter k přidání výchozích parametrů na začátek pipeline bez explicitní registrace výchozího middlewaru. IStartupFilter umožňuje, aby jiná komponenta volala Use{Middleware} jménem autora aplikace.

• Vytvořit potrubí Configure metod. IStartupFilter.Configure může nastavit middleware, který se má spustit před nebo po přidání middlewaru knihovnami.

Implementace IStartupFilter poskytuje metodu Configure , která přijímá a vrací Action<IApplicationBuilder>. Definuje IApplicationBuilder třídu pro konfiguraci kanálu žádosti aplikace. Další informace najdete v tématu Vytvoření kanálu middlewaru pomocí nástroje IApplicationBuilder.

Každá implementace IStartupFilter může do kanálu požadavku přidat jeden nebo více middlewarů. Filtry se vyvolávají 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řipojí k začátku nebo konci kanálu aplikace.

Následující příklad ukazuje, jak zaregistrovat middleware s IStartupFilter. 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);
    }
}

RequestSetOptionsMiddleware je konfigurován ve třídě RequestSetOptionsStartupFilter.

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

Implementace IStartupFilter se zaregistruje v souboru 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 pro option, middleware zpracuje přiřazení hodnoty předtím, než middleware ASP.NET Core 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í provádění middlewaru IStartupFilter je nastaveno pořadím registrací:

• Několik IStartupFilter implementací může pracovat se stejnými objekty. Pokud je pořadí důležité, seřaďte IStartupFilter registrace služeb tak, aby odpovídaly pořadí, v jakém by se měly spouštět jejich middleware.

• Knihovny můžou přidat middleware s jednou nebo více implementacemi IStartupFilter, které běží před a po jiném aplikačním middleware zaregistrovaném v 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.

  • Chcete-li jej vyvolat později, zaregistrujte službu po přidání knihovny.

Aplikaci ASP.NET Core nelze rozšířit, když přepíšete Configure. Další informace najdete v tématu GitHub /dotnet/aspnetcore/issues #45372.

Přidejte konfiguraci během spuštění z externí sestavy

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

Spuštění, nastavení služeb a konfigurace

Informace o používání ConfigureServices a Configure metod s minimálním modelem hostování najdete v tématech:

• Použijte spuštění s minimálním modelem hostování
• Spouštěcí třída (.NET 5 verze tohoto článku):
  • Metoda ConfigureServices
  • Konfigurační metoda

Související obsah

• Přehled základních principů ASP.NET
• Konfigurace v ASP.NET Core