JsonSerializerOptions.RespectNullableAnnotations Özellik

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-preview.7.24405.7

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, set

Public Property RespectNullableAnnotations As Boolean

Özellik Değeri

Boolean

Özel durumlar

InvalidOperationException

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.