JsonSerializerOptions.RespectRequiredConstructorParameters プロパティ

  • リファレンス

定義

名前空間:
System.Text.Json
アセンブリ:
System.Text.Json.dll
パッケージ:
System.Text.Json v9.0.0-rc.2.24473.5

逆シリアル化中にオプション以外のコンストラクター パラメーターを指定する必要があるかどうかを示す値を取得または設定します。

public:
 property bool RespectRequiredConstructorParameters { bool get(); void set(bool value); };
public bool RespectRequiredConstructorParameters { get; set; }
member this.RespectRequiredConstructorParameters : bool with get, set
Public Property RespectRequiredConstructorParameters As Boolean

プロパティ値

Boolean

例外

InvalidOperationException

このプロパティは、シリアル化または逆シリアル化が発生した後に設定されます。

注釈

履歴上の理由から、コンストラクターベースの逆シリアル化では、すべてのコンストラクター パラメーターが既定で省略可能として扱われます。JSON ペイロードに存在しない場合は、不足しているパラメーターに既定値を入力します。 このフラグを使用すると、ユーザーは JsonSerializerOptions インスタンスごとに必要に応じてその動作を切り替えることができます。 このプロパティの既定の設定は、"System.Text.Json.Serialization.RespectRequiredConstructorParametersDefault" 機能スイッチを使用して、アプリケーション全体で切り替えることができます。

新しいアプリケーションでは、このプロパティを常に trueに設定し、密接に関連する RespectNullableAnnotations プロパティと組み合わせて使用することをお勧めします。

適用対象