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.

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

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 spouštění a optimalizovaly ho. Událost ServerReady představuje bod, ve Microsoft.AspNetCore.Hosting kterém je server připravený reagovat na požadavky.

Další informace o spuštění aplikace najdete v tématu ASP.NET Základní přehled.

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

IStartupFilter použijte:

• Konfigurace middlewaru na začátku nebo 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, aby jiná komponenta volala Use{Middleware} jménem autora aplikace.
• Vytvoření kanálu Configure metod IStartupFilter.Configure může nastavit middleware, který se má spustit před nebo po přidání middlewaru knihovnami.

IStartupFilterimplementuje 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ý z nich 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řed nebo po předání ovládacího prvku do dalšího filtru přidat middleware, a proto se připojují 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);
    }
}

Konfiguruje se RequestSetOptionsMiddleware 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 registrován 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 option řetězce dotazu, middleware zpracuje přiřazení hodnoty před middlewarem 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 řazení důležité, objednejte si IStartupFilter registrace služeb tak, aby odpovídaly objednávce, kterou by měly spouštět jejich middlewary.

• Knihovny mohou přidat middleware s jednou nebo více IStartupFilter implementacemi, které běží před nebo po jiném middlewaru aplikace zaregistrovaného v IStartupFilteraplikaci . 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 volat později, umístěte registraci služby po přidání knihovny.

Poznámka: Při přepsání Configurenení možné rozšířit aplikaci ASP.NET Core. 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řidání vylepšení do 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í, konfigurace 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žití startupu s minimálním modelem hostování
• Verze tohoto článku ASP.NET Core 5.0:
  • Metoda ConfigureServices
  • Metoda Configure