OpenApiVersion wordt standaard ingesteld op OpenApi3_2

De standaardwaarde van is gewijzigd van OpenApiVersionOpenApiSpecVersion.OpenApi3_1 in OpenApiSpecVersion.OpenApi3_2. Apps die afhankelijk zijn van openAPI 3.1-uitvoer zonder expliciet de versie in te stellen, produceren nu OpenAPI 3.2-documenten.

Geïntroduceerde versie

.NET 11 preview 6

Vorig gedrag

Voorheen was OpenApiOptions.OpenApiVersion standaard ingesteld op OpenApiSpecVersion.OpenApi3_1. Aanroepen AddOpenApi zonder expliciet een versie in te stellen, heeft een OpenAPI 3.1-document geproduceerd.

Nieuw gedrag

Vanaf ASP.NET Core 11 Preview 6 wordt OpenApiOptions.OpenApiVersion standaard ingesteld op OpenApiSpecVersion.OpenApi3_2. Aanroepen AddOpenApi zonder expliciet een versie in te stellen, produceert nu een OpenAPI 3.2-document.

Type van brekende verandering

Deze wijziging is een gedragswijziging.

Reden voor wijziging

de OpenAPI-ondersteuning van ASP.NET Core maakt gebruik van de nieuwste uitgebrachte versie van de OpenAPI-specificatie als de standaardinstelling, zodat apps profiteren van nieuwe mogelijkheden zonder extra configuratie.

Aanbevolen actie

In de meeste gevallen is er geen actie nodig. Als u downstreamhulpprogramma's wilt ondersteunen die OpenAPI 3.2 nog niet verwerken, configureert u de versie expliciet:

builder.Services.AddOpenApi(options =>
{
    options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_1;
});

Betreffende API's

• OpenApiVersion