Tag: minimal-apis

Geben Sie in ASP.NET Core 11 Results<T1, TN> mit TypedResults für Minimal APIs und ActionResult<T> für Controllers zurück. Behandeln Sie das nackte IResult und das nackte IActionResult als Notausgänge: Sie kompilieren für jede Antwort, beschreiben OpenAPI aber nichts, sodass Sie in handgeschriebenen ProducesResponseType-Attributen dafür bezahlen.

Preview 6 ergänzt AsyncValidationAttribute und IAsyncValidatableObject, damit DataAnnotations-Regeln die Datenbank abfragen können, bevor Ihr Endpunkt läuft, ohne einen Thread zu blockieren.

Deklarieren Sie den Rückgabetyp des Handlers als Results<Ok<T>, NotFound> und geben Sie TypedResults.Ok / TypedResults.NotFound zurück: Die Union bietet eine Prüfung zur Kompilierzeit, dass der Handler nur zurückgibt, was er deklariert, und beschreibt sich selbst gegenüber OpenAPI, sodass Sie .Produces nie von Hand schreiben. Behandelt asynchrone Handler, das Sechs-Typen-Limit und Tests in ASP.NET Core 11.

Eine Schritt-für-Schritt-Anleitung, um handgeschriebene if-Prüfungen in den Handlern einer ASP.NET-Core-11-Minimal-API durch den integrierten, quellcodegenerierten DataAnnotations-Validator zu ersetzen: was bricht, welche manuellen Regeln portierbar sind und welche nicht, und wie Sie prüfen, dass der 400-ProblemDetails-Vertrag identisch bleibt.

Eine Minimal API gibt 415 zurück, wenn der Content-Type der Anfrage nicht zu dem passt, was der Endpunkt bindet. Senden Sie Content-Type: application/json für einen aus dem Body gebundenen Typ, oder verwenden Sie [FromForm] für Formular- und Datei-Uploads.

Rufen Sie AddProblemDetails mit einem CustomizeProblemDetails-Callback auf, um die 400 umzuformen, die die integrierte Minimal-API-Validierung in ASP.NET Core 11 zurückgibt: fügen Sie eine traceId hinzu, schreiben Sie den title um, wechseln Sie von 400 zu 422 oder übernehmen Sie mit einem eigenen IProblemDetailsWriter die volle Kontrolle.

Verwenden Sie die integrierte, per Source Generator erzeugte Validierung für synchrone, per Attribut ausdrückbare Regeln in ASP.NET Core 11; greifen Sie zu FluentValidation, wenn Sie asynchrone Regeln, komplexe feldübergreifende Logik oder Validierung außerhalb Ihrer Domänenmodelle benötigen.

Ein vollständiger Leitfaden zur Strukturierung von Minimal APIs in ASP.NET Core 11 mit MapGroup: Endpunkt-Module pro Ressource als Erweiterungsmethoden, verschachtelte Gruppen, gemeinsame Filter und Authentifizierung, Präfixe mit Routenparametern, OpenAPI-Tags und die überraschenden Regeln zur Filterreihenfolge.

ASP.NET Core 11 bietet eingebaute Validierung für Minimal APIs: Rufen Sie AddValidation auf, annotieren Sie Ihren Request-Record mit DataAnnotations, und ein Source Generator validiert das gebundene Modell und gibt 400 ProblemDetails zurück, bevor Ihr Handler läuft. Ohne Controller, ohne FluentValidation, ohne manuelle Prüfungen.

.NET 11 Preview 4 sorgt dafur, dass die OpenAPI-Generierung in ASP.NET Core HTTP QUERY als erstklassige Operation in OpenAPI 3.2 erkennt, mit einem eleganten Fallback fur 3.0- und 3.1-Dokumente.