Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Standardwert von OpenApiVersion wurde von OpenApiSpecVersion.OpenApi3_1 auf OpenApiSpecVersion.OpenApi3_2 geändert. Apps, die von der OpenAPI 3.1-Ausgabe abhängen, ohne die Version explizit festzulegen, erzeugen jetzt OpenAPI 3.2-Dokumente.
Eingeführt in Version
.NET 11 Vorschau 6
Bisheriges Verhalten
Zuvor war OpenApiOptions.OpenApiVersion standardmäßig auf OpenApiSpecVersion.OpenApi3_1 eingestellt. Der Aufruf von AddOpenApi ohne explizit eine Version festzulegen führte zu einem OpenAPI-3.1-Dokument.
Neues Verhalten
Ab ASP.NET Core 11 Preview 6 ist OpenApiOptions.OpenApiVersion standardmäßig auf OpenApiSpecVersion.OpenApi3_2 festgelegt. Das Aufrufen AddOpenApi ohne explizite Festlegung einer Version erzeugt jetzt ein OpenAPI 3.2-Dokument.
Art der einschneidenden Änderung
Diese Änderung ist eine Verhaltensänderung.
Grund für die Änderung
die OpenAPI-Unterstützung von ASP.NET Core verwendet die neueste veröffentlichte Version der OpenAPI-Spezifikation als Standard, sodass Apps von neuen Funktionen ohne zusätzliche Konfiguration profitieren.
Empfohlene Maßnahme
In den meisten Fällen ist keine Aktion erforderlich. Um nachgeschaltete Tools zu unterstützen, die OpenAPI 3.2 noch nicht verarbeiten, konfigurieren Sie die Version explizit:
builder.Services.AddOpenApi(options =>
{
options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});
Betroffene APIs
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
