JsonSerializerOptions.RespectRequiredConstructorParameters Eigenschaft

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-rc.2.24473.5

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob nicht optionale Konstruktorparameter während der Deserialisierung angegeben werden sollen.

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

Eigenschaftswert

Boolean

Ausnahmen

InvalidOperationException

Diese Eigenschaft wird festgelegt, nachdem die Serialisierung oder Deserialisierung aufgetreten ist.

Hinweise

Aus historischen Gründen behandelt die konstruktorbasierte Deserialisierung alle Konstruktorparameter standardmäßig als optional und füllt fehlende Parameter mit Standardwerten aus, wenn sie nicht in der JSON-Nutzlast vorhanden sind. Mit dieser Kennzeichnung können Benutzer dieses Verhalten bei Bedarf für jede JsonSerializerOptions Instanz umschalten. Die Standardeinstellung für diese Eigenschaft kann mithilfe des Featureschalters "System.Text.Json.Serialization.RespectRequiredConstructorParametersDefault" anwendungsweit umgeschaltet werden.

Es wird empfohlen, dass neue Anwendungen diese Eigenschaft immer auf truefestlegen, in Kombination mit der eng verbundenen RespectNullableAnnotations-Eigenschaft.