ASP0014: Empfehlen der Verwendung von Routenregistrierungen auf oberster Ebene

Ursache

Routen können direkt auf der obersten Ebene einer Minimal-API-Anwendung registriert werden.

Regelbeschreibung

Routen können direkt auf der obersten Ebene einer Minimal-API-Anwendung registriert werden und müssen nicht innerhalb eines Aufrufs von UseEndpoints geschachtelt sein.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

app.Run();

Behandeln von Verstößen

Um einen Verstoß gegen diese Regel zu beheben, registrieren Sie die Endpunkte direkt für WebApplication.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

app.Run();

Wann sollten Warnungen unterdrückt werden?

Warnungen aus dieser Regel können unterdrückt werden, wenn der UseEndpoints-Zielaufruf ohne Zuordnungen als Strategie zum Organisieren der Middlewarereihenfolge erfolgt.

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

app.Run();