コレクション プロパティに対する JsonNumberHandlingAttribute

JsonNumberHandlingAttribute 属性に関するマイナーな破壊的変更が .NET 6 で導入されました。 数値以外の値のコレクションであるプロパティに属性を適用して、そのプロパティをシリアル化または逆シリアル化しようとすると、InvalidOperationException がスローされます。 この属性は、次のように、数値型のコレクションであるプロパティに対してのみ有効です。

[JsonNumberHandling(JsonNumberHandling.AllowReadingFromString | JsonNumberHandling.WriteAsString)]
public List<int> MyList { get; set; }

以前の動作

シリアル化中に無視されていましたが、非数値型のコレクションであるプロパティに JsonNumberHandlingAttribute を適用することは可能でした。 次に例を示します。

[JsonNumberHandling(JsonNumberHandling.AllowReadingFromString | JsonNumberHandling.WriteAsString)]
public List<MyClass> MyList { get; set; }

新しい動作

.NET 6 以降、数値以外の値のコレクションであるプロパティに JsonNumberHandlingAttribute を適用して、そのプロパティをシリアル化または逆シリアル化しようとすると、InvalidOperationException がスローされます。

導入されたバージョン

.NET 6

破壊的変更の種類

この変更は、バイナリの互換性に影響を与える可能性があります。

変更理由

この変更は、数値処理機能のパフォーマンス最適化の副作用でした。

推奨される操作

互換性のないコレクション プロパティから JsonNumberHandlingAttribute 属性を削除します。

影響を受ける API

System.Text.Json.JsonSerializer のシリアル化および逆シリアル化メソッドのすべて。