ASP0014:建議使用最上層路由註冊

規則識別碼 ASP0014
類別 使用方式
修正程式是中斷或非中斷 不中斷

原因

可以直接在基本 API 應用程式的最上層註冊路由。

檔案描述

可以直接在基本 API 應用程式的最上層註冊路由,而不需要於 UseEndpoints 呼叫內建立巢狀。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.UseEndpoints(endpoints =>
{
    endpoints.MapGet("/", () => "Hello World!");
});

app.Run();

如何修正違規

若要修正此規則的違規,請直接在 WebApplication 上註冊端點。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

隱藏警告的時機

如果叫用目標 UseEndpoints 叫用而未使用任何對應做為組織中介軟體排序的策略,則可以隱藏此規則的警告。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

#pragma warning disable ASP0014
app.UseEndpoints(e => {});
#pragma warning restore ASP0014

app.Run();