Start Debugging

Tag: openapi

18 Beiträge · Seite1von2

2026-10-20 aspnetcore openapi dotnet-11

Wie Sie die Antwort einer Controller-Action im integrierten OpenAPI-Dokument von ASP.NET Core als nullbar markieren

Microsoft.AspNetCore.OpenApi markiert eine Antwort nur dann als nullbar, wenn die Action ein reines T? zurückgibt (und unter .NET 10 nicht einmal Task<T?>). ActionResult<T?> und IActionResult verlieren die Annotation sowohl unter .NET 10 als auch unter .NET 11 RC2. Hier steht der Grund, ein getesteter Operation Transformer, der das behebt, und die Falle mit 204 No Content, durch die die Spezifikation lügt, wenn Sie nicht auch den Formatter von MVC ändern.

2026-10-17 aspnetcore aspnetcore-11 identity

Einzelne von MapIdentityApi abgebildete Endpunkte in ASP.NET Core entfernen oder ausblenden

MapIdentityApi<TUser>() bildet zehn Endpunkte ab und bietet keinen Schalter, um einen davon auszulassen. Hier sind vier gemessene Wege unter .NET 11: einen Endpunkt aus OpenAPI ausblenden, ihn 404 zurückgeben lassen, ihn überlagern oder ihn komplett aus dem Routing entfernen, plus die /confirmEmail-Falle, die die Registrierung in einen 500-Fehler verwandelt.

2026-09-11 csharp csharp-15 dotnet-11

C#-Unions in ASP.NET Core 11: Bodys, SignalR und OpenAPI funktionieren, Query Strings nicht

Das ASP.NET Core-Team hat kartiert, wo C# 15-Union-Typen in .NET 11 funktionieren: Bodys in Minimal APIs und MVC, das JsonHubProtocol von SignalR, Blazor und anyOf-Schemas in OpenAPI. Binding aus Route, Query, Headern und Formularen wird noch nicht unterstützt.

2026-08-19 errors swashbuckle openapi

Lösung: OpenAPI 3.0 lässt sich nach dem Update auf Swashbuckle.AspNetCore v9 nicht mehr erzeugen

Swashbuckle 8 und neuer geben openapi 3.0.4 aus, nicht 3.0.1, und es gibt keine OpenApiSpecVersion für Patch-Versionen. Warum sich das geändert hat und vier Wege, die erwartete Zeichenkette zu erzwingen.

2026-08-19 errors openapi swagger

Fix: Swagger UI zeigt Unable to render this definition nach dem Upgrade auf .NET 11

ASP.NET Core 11 gibt standardmäßig openapi 3.2.0 aus, und Swagger UI unter 10.1.5 lehnt das ab. Swashbuckle.AspNetCore.SwaggerUI aktualisieren oder OpenApiVersion auf OpenApi3_1 setzen.

2026-08-15 comparison csharp dotnet

Scalar vs Swagger UI für OpenAPI-Dokumentation in ASP.NET Core 11

Scalar liefert 1,02 MiB gzip-komprimiertes JavaScript und einen deutlich besseren Request-Builder. Swagger UI liefert 514 KiB und rendert OpenAPI 3.2, was .NET 11 inzwischen standardmäßig ausgibt. Gemessene Payloads, die 3.2-Lücke, Endpoint-Routing auf beiden Seiten und die Authentifizierungsdetails, die entscheiden.

2026-08-12 errors aspnetcore dotnet

Lösung: The 'interceptors' feature is not enabled in this namespace

CS9137 stammt vom Source Generator in Microsoft.AspNetCore.OpenApi. Fügen Sie InterceptorsNamespaces in jedem Projekt hinzu, das AddOpenApi aufruft, nicht nur im Projekt mit der PackageReference.

2026-08-11 errors aspnetcore dotnet

Lösung: The type or namespace name 'OpenApiReference' could not be found

OpenApiReference wurde in Microsoft.OpenApi 2.0 entfernt. Das using auf Microsoft.OpenApi zu ändern reicht nicht: Ersetzen Sie jede Verwendung durch eine typisierte Referenz wie OpenApiSchemaReference.

2026-08-09 csharp dotnet dotnet-11

OpenAPI-Dokumentation mit Scalar statt Swagger UI in ASP.NET Core 11 bereitstellen

Ersetzen Sie UseSwaggerUI durch MapScalarApiReference in ASP.NET Core 11: Routing, mehrere Dokumente, vorausgefüllte Authentifizierung, Absicherung in Produktion, Assets ohne CDN und die Scalar-eigenen OpenAPI-Erweiterungen.

2026-07-24 migration swashbuckle openapi

Swashbuckle IOperationFilter und ISchemaFilter zu OpenAPI-Transformern in .NET 11 migrieren

Eine Filter-für-Filter-Migrationsreferenz, um IOperationFilter- und ISchemaFilter-Code von Swashbuckle zu den integrierten Operations- und Schema-Transformern in .NET 11 zu überführen, mit dem Mapping der Kontextobjekte und den Microsoft.OpenApi-v2-Änderungen, die die Kompilierung brechen.