System.Text.Json IAsyncEnumerable-serialisering

System.Text.Json stöder nu serialisering och deserialisering av IAsyncEnumerable<T> instanser.

Tidigare beteende

I tidigare versioner System.Text.Json serialiserade IAsyncEnumerable<T> instanser som tomma JSON-objekt ({}). Deserialiseringen misslyckades med en JsonException.

Nytt beteende

Asynkrona serialiseringsmetoder räknar nu upp alla IAsyncEnumerable<T> instanser i ett objektdiagram och serialiserar dem sedan som JSON-matriser. Synkrona serialiseringsmetoder stöder inte IAsyncEnumerable<T> serialisering och genererar en NotSupportedException.

Version lanserad

.NET 6

Typ av brytande ändring

Den här ändringen kan påverka källkompatibilitet. Om du ändrar målet till .NET 6 får du inga kompilationsfel, men du kan stöta på skillnader i serialisering under körningens gång.

Orsak till ändring

Den här ändringen introducerades för att lägga till stöd för strömningssvar IAsyncEnumerable<T> i ASP.NET Core MVC.

Rekommenderad åtgärd

Kontrollera om serialiseringsmodellerna innehåller typer som implementerar IAsyncEnumerable<T> och avgör om det är önskvärt att generera uppräkningen i JSON-utdata. Du kan inaktivera IAsyncEnumerable<T> serialisering på något av följande sätt:

• Koppla en JsonIgnoreAttribute till egenskapen som innehåller IAsyncEnumerable<T>.
• Definiera en anpassad konverterarfabrik som serialiserar IAsyncEnumerable<T> instanser som tomma JSON-objekt.

Berörda API:er

• System.Text.Json.JsonSerializer.SerializeAsync
• System.Text.Json.JsonSerializer.Serialize

Se även

• System.Text.Json-stöd för IAsyncEnumerable