JsonSerializerOptions.RespectNullableAnnotations Egenskap

public:
 property bool RespectNullableAnnotations { bool get(); void set(bool value); };

public bool RespectNullableAnnotations { get; set; }

member this.RespectNullableAnnotations : bool with get, set

Public Property RespectNullableAnnotations As Boolean

Egenskapsvärde

Undantag

Kommentarer

Konfigurerar serialiseraren för att utlösa ett undantag när du försöker serialisera ett null värde från en egenskap som inte kan nulliseras, eller när du deserialiserar ett null värde till en egenskapsuppsättning eller konstruktorparameter som inte kan nulliseras. Nullabilitetsanteckningar matchas från de egenskaper, fält och konstruktorparametrar som används av serialiseraren. Detta inkluderar anteckningar som härrör från attribut som NotNullAttribute, MaybeNullAttributeoch AllowNullAttributeDisallowNullAttribute.

På grund av begränsningar i hur nullbara referenstyper representeras vid körning styr den här inställningen endast nullabilitetsanteckningar för icke-generiska egenskaper, fält och konstruktorparametrar. Det kan inte användas för att framtvinga nullanoteringar av typer på rotnivå, samlingselement eller allmänna parametrar. Standardinställningen för den här egenskapen kan växlas programomfattande med hjälp av funktionsväxeln "System.Text.Json.Serialization.RespectNullableAnnotationsDefault".

Validering av nullabilitet fungerar oberoende av validering av krav, det vill säga att inställningen inte har någon effekt i scenarier där nyttolasten saknar en nödvändig egenskap. Detta kan konfigureras oberoende av nyckelordet required , JsonRequiredAttribute attributet eller egenskapen RespectRequiredConstructorParameters .

Vi rekommenderar att nya program alltid anger den här egenskapen till true, i kombination med den nära relaterade RespectRequiredConstructorParameters egenskapen.