JsonSerializerOptions.RespectNullableAnnotations Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Serileştirme ve seri durumdan çıkarma sırasında null atanabilirlik ek açıklamalarına uyulup uyulmayacağını belirten bir değer alır veya ayarlar.
public:
property bool RespectNullableAnnotations { bool get(); void set(bool value); };public bool RespectNullableAnnotations { get; set; }member this.RespectNullableAnnotations : bool with get, setPublic Property RespectNullableAnnotations As BooleanÖzellik Değeri
Özel durumlar
Bu özellik serileştirme veya seri durumdan çıkarma oluştuktan sonra ayarlanır.
Açıklamalar
Null değer atanamayan bir özellik alıcısından bir null değerini seri hale getirmeye çalışırken veya bir null değerini null atanamayan bir özellik ayarlayıcısı veya oluşturucu parametresine seri durumdan çıkarırken seri hale getiriciyi özel durum oluşturacak şekilde yapılandırır. Boş değer atanabilirlik ek açıklamaları, seri hale getirici tarafından kullanılan özellikler, alanlar ve oluşturucu parametrelerinden çözümlenir. Bu, NotNullAttribute, MaybeNullAttribute, AllowNullAttribute ve DisallowNullAttributegibi özniteliklerden kaynaklanan ek açıklamaları içerir.
Boş değer atanabilir başvuru türlerinin çalışma zamanında nasıl temsil edilir kısıtlamaları nedeniyle, bu ayar yalnızca genel olmayan özelliklerin, alanların ve oluşturucu parametrelerinin null atanabilirlik ek açıklamalarını yönetir. Kök düzeyindeki türlerin, koleksiyon öğelerinin veya genel parametrelerin null atanabilirlik ek açıklamalarını zorunlu kılmak için kullanılamaz. Bu özelliğin varsayılan ayarı, "System.Text.Json.Serialization.RespectNullableAnnotationsDefault" özellik anahtarı kullanılarak uygulama genelinde değiştirilebilir.
Nullability doğrulama işlevleri, gereklilik doğrulamasından bağımsız olarak çalışır; yani yükün gerekli bir özelliğin eksik olduğu senaryolarda ayarın hiçbir etkisi yoktur. Bu, required anahtar sözcüğü, JsonRequiredAttribute özniteliği veya RespectRequiredConstructorParameters özelliği kullanılarak bağımsız olarak yapılandırılabilir.
Yeni uygulamaların bu özelliği her zaman yakın ilişkili RespectRequiredConstructorParameters özelliğiyle birlikte trueolarak ayarlamaları önerilir.
