ASP.NET Core 中的應用程式啟動

作者：Rick Anderson

使用 Web 範本建立的 ASP.NET Core 應用程式包含 Program.cs 檔案中的應用程式啟動程式碼。

有關 Blazor 新增或取代本文指導的啟動指導，請參閱 ASP.NET Core Blazor 啟動。

下列應用程式啟動程式碼支援：

• Razor Pages
• MVC 控制器與檢視
• Web API 與控制器
• 基本 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();

使用 EventSource 的應用程式可以測量啟動時間，以瞭解並最佳化啟動效能。 Microsoft.AspNetCore.Hosting 中的 ServerReady 事件代表伺服器準備好回應要求的點。

如需應用程式啟動的詳細資訊，請參閱 ASP.NET Core 基本概念的概觀。

使用啟動篩選條件來擴充啟動

使用 IStartupFilter：

• 在應用程式中介軟體管線的開頭或結尾設定中介軟體，而不需明確呼叫 Use{Middleware}。 使用 IStartupFilter 將預設值新增至管線開頭，而不需明確註冊預設中介軟體。 IStartupFilter 允許不同的元件代表應用程式作者呼叫 Use{Middleware}。
• 建立 Configure 方法的管線。 IStartupFilter.Configure 可以將中介軟體設為在程式庫新增中介軟體之前或之後執行。

IStartupFilter 會實作 Configure，其會接收並傳回 Action<IApplicationBuilder>。 IApplicationBuilder 會定義類別，以設定應用程式的要求管線。 如需詳細資訊，請參閱使用 IApplicationBuilder 建立中介軟體管線。

每個 IStartupFilter 都可在要求管線中新增一或多個中介軟體。 篩選條件將依照它們新增至服務容器的順序叫用。 篩選條件可能會在控制權傳給下一個篩選條件之前或之後新增中介軟體，因此它們會附加至應用程式管線的開頭或結尾。

以下範例示範如何使用 IStartupFilter 註冊中介軟體。 此 RequestSetOptionsMiddleware 中介軟體會從查詢字串參數設定選項值：

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 設定在 RequestSetOptionsStartupFilter 類別中：

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

IStartupFilter 已在 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();

提供 option 的查詢字串參數時，中介軟體會在 ASP.NET Core 中介軟體轉譯回應之前，先處理值的指派：

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

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

中介軟體執行順序是依照 IStartupFilter 註冊順序來設定：

• 多個 IStartupFilter 實作可能會與相同的物件互動。 如果順序很重要，請排列其 IStartupFilter 服務註冊順序，以符合其中介軟體執行應該依照的順序。

• 程式庫可能使用一或多個 IStartupFilter 實作 (其在使用 IStartupFilter 註冊的其他應用程式中介軟體之前或之後執行) 來新增中介軟體。 在由程式庫的 IStartupFilter 所新增中介軟體之前叫用 IStartupFilter 中介軟體：

  • 先放置服務註冊，再將程式庫新增至服務容器。
  • 若要在之後叫用，請在新增程式庫之後放置服務註冊。

注意：覆寫 Configure 時，您無法擴充 ASP.NET Core 應用程式。 如需詳細資訊，請參閱這個 GitHub 問題。

在啟動時從外部組件新增組態

IHostingStartup 實作允許在啟動時從應用程式 Program.cs 檔案之外的外部組件，針對應用程式新增增強功能。 如需詳細資訊，請參閱在 ASP.NET Core 中使用裝載啟動組件 (部分機器翻譯)。

Startup、ConfigureServices 和 Configure

如需搭配最小裝載模型使用 ConfigureServices 和 Configure 方法的詳細資訊，請參閱：

• 搭配最小裝載模型使用 Startup
• 本文的 ASP.NET Core 5.0 版本：
  • ConfigureServices 方法
  • Configure 方法