コレクション プロパティに対する 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 シリアル化および逆シリアル化メソッド。