Tag: minimal-apis

Ein Dictionary mit [FromForm] bindet in einer Minimal API mit leerem Präfix: die Formularschlüssel müssen [key] heißen, nicht metadata[key]. Kapseln Sie es in einer Klasse für lesbare Namen.

Verzichten Sie komplett auf das JS-Modul downloadFileFromStream. Rendern Sie einen Anker mit dem download-Attribut, der auf einen Minimal-API-Endpunkt mit TypedResults.File zeigt, oder senden Sie ein einfaches HTML-Formular per POST mit einem AntiforgeryToken. Enthält, warum das download-Attribut verhindert, dass Blazors Enhanced Navigation den Klick schluckt, warum data-enhance die Datei stillschweigend verwirft, und die Cookie-gegen-Bearer-Falle.

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.