.NET 'te JSON serileştirme ve seri durumundan çıkarma (sıralama ve kaldırma)-genel bakış
System.Text.JsonAd alanı, JavaScript nesne gösterimi (JSON) öğesinden serileştirmek ve seri durumdan çıkarmak için işlevsellik sağlar.
Kitaplık tasarımı, kapsamlı bir özellik kümesi üzerinden yüksek performans ve düşük bellek ayırmayı vurgular. Yerleşik UTF-8 desteği, UTF-8 olarak kodlanmış JSON metnini okuma ve yazma sürecini en iyi duruma getirir. Bu, Web ve disk üzerindeki dosyalardaki veriler için en yaygın kodlama olur.
Kitaplık Ayrıca, bellek içi belge nesne modeli (DOM) ile çalışmak için sınıflar sağlar. Bu özellik bir JSON dosyası veya dizesindeki öğelerin rastgele salt okunurdur erişimine izin vermez.
kitaplığın Visual Basic koddan kullanabileceğiniz bölümlerine ilişkin bazı sınırlamalar vardır. daha fazla bilgi için bkz. Visual Basic desteği.
Çalışma zamanı Reflection ve derleme zamanı kaynağı oluşturma karşılaştırması
Varsayılan olarak, System.Text.Json serileştirme ve seri durumundan çıkarma için nesnelerin özelliklerine erişmesi gereken meta verileri toplamak üzere çalışma zamanı yansımasını kullanır. Alternatif olarak, System.Text.Json performansı artırmak, özel bellek kullanımını azaltmak ve uygulama boyutunu azaltan derleme kırpmasınıkolaylaştırmak için C# kaynak oluşturma özelliğini kullanabilir. Daha fazla bilgi için bkz. ' de System.Text.Json yansıma veya kaynak oluşturmayı seçme .
Kitaplığı alma
Kitaplık, .NET Core 3,0 ve üzeri sürümler için paylaşılan Framework 'ün bir parçası olarak yerleşik olarak bulunur. Kaynak oluşturma özelliği, .NET 6 ve üzeri sürümler için paylaşılan Framework 'ün bir parçası olarak yerleşik olarak bulunur. Kaynak oluşturma kullanımı, .NET 5 SDK veya üstünü gerektirir.
.net Core 3,0 ' den önceki framework sürümleri için System.Text.Json NuGet paketini yüklemelisiniz. Paket şunları destekler:
- .NET Standard 2,0 ve üzeri
- .NET Framework 4.7.2 ve üzeri
- .NET Core 2,1 ve üzeri
- .NET 5 ve üzeri
Güvenlik bilgileri
Tasarlarken kabul edilen güvenlik tehditleri JsonSerializer ve nasıl hafiflebilecekleri hakkında bilgi için bkz. System.Text.Json Threat model.
İş parçacığı güvenliği
System.Text.JsonTürler aşağıdakiler dahil olmak üzere iş parçacığı güvenlidir:
Ek kaynaklar
- Kitaplığı kullanma
- JsonSerializerOptions örneklerinin örneğini oluşturma
- Büyük/küçük harf duyarlı eşlemeyi etkinleştirme
- Özellik adlarını ve değerlerini özelleştirme
- Özellikleri yoksayma
- Geçersiz JSON’a izin verme
- Taşma JSON 'ı veya JsonElement veya JsonNode kullanın
- Başvuruları koru ve döngüsel başvuruları işle
- Sabit türler ve genel olmayan erişimciler için seri durumdan çıkarma
- Polimorfik serileştirme
- ' Den ' a geçiş Newtonsoft.JsonSystem.Text.Json
- Karakter kodlamasını özelleştirme
- DOM, Utf8JsonReader ve Utf8JsonWriter kullanma
- JSON serileştirme için özel dönüştürücüler yazma
- DateTime ve DateTimeOffset desteği
- Kaynak oluşturmayı kullanma
- Desteklenen koleksiyon türleri
- System.Text.Json API başvurusu
- System.Text.Json. Serileştirme API başvurusu