ASP0014：建議使用頂層路線註冊

	價值觀
規則識別碼	ASP0014
類別	Usage
修正是破壞性或非破壞性	Non-breaking

原因

路由可以直接在最小 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();