Uruchamianie aplikacji na platformie ASP.NET Core

Autor: Rick Anderson

Aplikacje platformy ASP.NET Core tworzone za pomocą szablonów internetowych zawierają kod uruchamiania aplikacji w pliku Program.cs.

Następujący kod uruchamiania aplikacji obsługuje:

• Razor Pages
• Kontrolery MVC z widokami
• Internetowy interfejs API z kontrolerami
• Minimalne interfejsy 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();

Aplikacje korzystające z usługi EventSource mogą mierzyć czas uruchamiania, aby zrozumieć i zoptymalizować wydajność uruchamiania. Zdarzenie ServerReady w programie Microsoft.AspNetCore.Hosting reprezentuje punkt, w którym serwer jest gotowy do odpowiadania na żądania.

Aby uzyskać więcej informacji na temat uruchamiania aplikacji, zobacz omówienie podstaw platformy ASP.NET Core.

Rozszerzanie uruchamiania przy użyciu filtrów uruchamiania

Można używać serwera IStartupFilter:

• Aby skonfigurować oprogramowanie pośredniczące na początku lub na końcu potoku oprogramowania pośredniczącego aplikacji bez jawnego wywołania metody Use{Middleware}. Służy IStartupFilter do dodawania wartości domyślnych na początku potoku bez jawnego rejestrowania domyślnego oprogramowania pośredniczącego. IStartupFilter umożliwia wywołanie Use{Middleware} innego składnika w imieniu autora aplikacji.
• Aby utworzyć potok Configure metod. IStartupFilter.Configure może ustawić oprogramowanie pośredniczące do uruchomienia przed oprogramowaniem pośredniczącym dodanym przez biblioteki lub po nim.

IStartupFilter implementuje Configureelement , który odbiera i zwraca element Action<IApplicationBuilder>. Element IApplicationBuilder definiuje klasę do konfigurowania potoku żądania aplikacji. Aby uzyskać więcej informacji, zobacz Tworzenie potoku oprogramowania pośredniczącego za pomocą programu IApplicationBuilder.

Każde z nich IStartupFilter może dodawać co najmniej jedno oprogramowanie pośredniczące w potoku żądania. Filtry są wywoływane w kolejności, w której zostały dodane do kontenera usługi. Filtry mogą dodawać oprogramowanie pośredniczące przed lub po przekazaniu kontrolki do następnego filtru, dlatego dołączają do początku lub końca potoku aplikacji.

W poniższym przykładzie pokazano, jak zarejestrować oprogramowanie pośredniczące w programie IStartupFilter. RequestSetOptionsMiddleware Oprogramowanie pośredniczące ustawia wartość opcji z parametru ciągu zapytania:

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

Element RequestSetOptionsMiddleware jest skonfigurowany w RequestSetOptionsStartupFilter klasie:

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

Element IStartupFilter jest zarejestrowany w pliku 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();

Po podaniu parametru ciągu zapytania oprogramowanie option pośredniczące przetwarza przypisanie wartości, zanim oprogramowanie pośredniczące ASP.NET Core renderuje odpowiedź:

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

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

Kolejność wykonywania oprogramowania pośredniczącego IStartupFilter jest ustawiana przez kolejność rejestracji:

• Wiele IStartupFilter implementacji może wchodzić w interakcje z tymi samymi obiektami. Jeśli zamawianie jest ważne, należy zamówić IStartupFilter rejestracje usług zgodnie z kolejnością uruchamiania oprogramowania pośredniczącego.

• Biblioteki mogą dodawać oprogramowanie pośredniczące z co najmniej jedną IStartupFilter implementacją uruchamianą przed lub po innym oprogramowaniem pośredniczącym aplikacji zarejestrowanym w IStartupFilterprogramie . Aby wywołać IStartupFilter oprogramowanie pośredniczące przed oprogramowaniem pośredniczącym dodanym przez bibliotekę IStartupFilter:

  • Umieść rejestrację usługi przed dodaniu biblioteki do kontenera usługi.
  • Aby wywołać później, umieść rejestrację usługi po dodaniu biblioteki.

Uwaga: nie można rozszerzyć aplikacji ASP.NET Core podczas zastępowania Configure. Aby uzyskać więcej informacji, zobacz ten problem z usługą GitHub.

Dodawanie konfiguracji podczas uruchamiania z zestawu zewnętrznego

Implementacja IHostingStartup umożliwia dodawanie ulepszeń do aplikacji podczas uruchamiania z zestawu zewnętrznego poza plikiem aplikacji Program.cs . Więcej informacji można znaleźć w temacie Korzystanie z hostowania zestawów startowych na platformie ASP.NET Core.

Uruchamianie, konfigurowanie usług i konfigurowanie

Aby uzyskać informacje na temat używania ConfigureServices metod i Configure z minimalnym modelem hostingu, zobacz:

• Używanie uruchamiania z minimalnym modelem hostingu
• Wersja tego artykułu ASP.NET Core 5.0:
  • Metoda ConfigureServices
  • Metoda Configure