ASP0014:建议使用顶层路由注册

规则 ID 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();