DataContractJsonSerializer Sınıf

Tanım

Nesneleri JavaScript Nesne Gösterimi'ne (JSON) serileştirir ve JSON verilerini nesnelere seri durumdan çıkartır. Bu sınıf devralınamaz.

public ref class DataContractJsonSerializer sealed
public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer
public sealed class DataContractJsonSerializer
public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer
type DataContractJsonSerializer = class
type DataContractJsonSerializer = class
    inherit XmlObjectSerializer
Public NotInheritable Class DataContractJsonSerializer
Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer
Devralma
DataContractJsonSerializer
Devralma
DataContractJsonSerializer

Açıklamalar

JSON'a seri hale getirme ve JSON'dan seri durumdan çıkarma içeren çoğu senaryo için System.Text.Json ad alanında API'leri öneririz.

Senaryonuz sınıfı gerektiriyorsa, bir türün DataContractJsonSerializer örneklerini bir JSON belgesine seri hale getirmek ve bir JSON belgesinin seri durumdan çıkarılıp bir tür örneğine seri durumdan çıkarmak için bunu kullanabilirsiniz. Örneğin, ad ve adres gibi temel verileri içeren özelliklere sahip adlı Person bir tür oluşturabilirsiniz. Daha sonra sınıfın Person bir örneğini oluşturup işleyebilir ve tüm özellik değerlerini daha sonra almak üzere bir JSON belgesine yazabilirsiniz. Bu JSON belgesi daha sonra sınıfına veya eşdeğer bir veri sözleşmesine sahip başka bir sınıfa seri durumdan Person çıkarılabilir.

Sunucuda giden yanıtın seri hale getirilmesi sırasında bir hata oluşursa veya yanıt işlemi başka bir nedenle bir özel durum oluşturursa, istemciye hata olarak döndürülmeyebilir.

Oluşturucular

Name Description
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)

Belirtilen tür ve seri hale getirici ayarlarındaki DataContractJsonSerializer bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini başlatır.

DataContractJsonSerializer(Type, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Belirtilen türde bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır. Bu yöntem ayrıca nesne grafında mevcut olabilecek bilinen türlerin listesini, serileştirilecek veya seri durumdan çıkarılacak en fazla grafik öğesi sayısını, beklenmeyen verileri yoksayma veya tür bilgilerini yayma ve özel serileştirme için bir vekil belirtir.

DataContractJsonSerializer(Type, IEnumerable<Type>)

Belirtilen türdeki DataContractJsonSerializer bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini başlatır ve nesne grafında mevcut olabilecek bilinen türlerden oluşan bir koleksiyon içerir.

DataContractJsonSerializer(Type, String, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Belirtilen türde bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır. Bu yöntem ayrıca XML öğesinin kök adını, nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek veya seri durumdan çıkarılacak en fazla grafik öğesi sayısını, beklenmeyen verileri yoksaymak veya tür bilgilerini yaymak ve özel serileştirme için bir vekil belirtir.

DataContractJsonSerializer(Type, String, IEnumerable<Type>)

Bir parametre tarafından belirtilen XML kök öğesini kullanarak belirtilen türdeki bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır ve nesne grafında mevcut olabilecek bilinen türler koleksiyonuyla.

DataContractJsonSerializer(Type, String)

Bir parametre tarafından belirtilen XML kök öğesini kullanarak belirtilen türdeki bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, IDataContractSurrogate, Boolean)

Belirtilen türde bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır. Bu yöntem ayrıca XML öğesinin kök adını, nesne grafında bulunabilecek bilinen türlerin listesini, serileştirilecek veya seri durumdan çıkarılacak en fazla grafik öğesi sayısını, beklenmeyen verileri yoksaymak veya tür bilgilerini yaymak ve özel serileştirme için bir vekil belirtir.

DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)

türündeki bir parametre tarafından belirtilen XML kök öğesini kullanarak belirtilen türdeki bir nesneyi serileştirmek veya seri durumdan DataContractJsonSerializerçıkarmak için sınıfının yeni bir örneğini XmlDictionaryString başlatır ve nesne grafiğinde mevcut olabilecek bilinen türlerden oluşan bir koleksiyon içerir.

DataContractJsonSerializer(Type, XmlDictionaryString)

türündeki bir parametre tarafından belirtilen XML kök öğesini kullanarak belirtilen türdeki bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializerXmlDictionaryStringbaşlatır.

DataContractJsonSerializer(Type)

Belirtilen türde bir nesneyi serileştirmek veya seri durumdan çıkarmak için sınıfının yeni bir örneğini DataContractJsonSerializer başlatır.

Özellikler

Name Description
DataContractSurrogate

Belirli IDataContractSurrogate bir örnek için şu anda etkin olan bir vekil türü alır. Vekiller serileştirme veya seri durumdan çıkarma işlemini genişletebilir.

DateTimeFormat

Nesne grafında tarih ve saat türü öğelerinin biçimini alır.

EmitTypeInformation

Tür bilgilerini yaymak için veri sözleşmesi JSON seri hale getirici ayarlarını alır veya ayarlar.

IgnoreExtensionDataObject

Seri durumdan çıkarmada bilinmeyen verilerin yoksayılıp yoksayılmayacağını ve serileştirmede arabirimin IExtensibleDataObject yoksayılıp yoksayılmayacağını belirten bir değer alır.

KnownTypes

Nesne grafında mevcut olabilecek türlerin bu örneği DataContractJsonSerializerkullanılarak seri hale getirilmiş bir koleksiyonunu alır.

MaxItemsInObjectGraph

Seri hale getiricinin tek bir okuma veya yazma çağrısında seri hale getirerek veya seri durumdan çıkararak nesne grafiğindeki en fazla öğe sayısını alır.

SerializeReadOnlyTypes

Salt okunur türleri serileştirip serileştirmeyeceğini belirten bir değer alır veya ayarlar.

UseSimpleDictionaryFormat

Basit sözlük biçiminin kullanılıp kullanılmayacağını belirten bir değer alır.

Yöntemler

Name Description
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetSerializationSurrogateProvider()

Geçerli serileştirme vekil sağlayıcısını alır.

GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
IsStartObject(XmlDictionaryReader)

seri hale getiricinin seri durumdan çıkarabileceği nesneyi temsil eden bir XML öğesinin üzerine konumlandırılıp konumlandırılmadığını XmlDictionaryReader belirten bir değer alır.

IsStartObject(XmlReader)

öğesinin XmlReader seri durumdan çıkarılabilen bir nesneye yerleştirilip yerleştirilmeyeceğini belirler.

MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
ReadObject(Stream)

JSON (JavaScript Nesne Gösterimi) biçimindeki bir belge akışını okur ve seri durumdan çıkarılmış nesneyi döndürür.

ReadObject(XmlDictionaryReader, Boolean)

JSON'dan eşlenen XML belgesini bir XmlDictionaryReader ile okur ve seri durumdan çıkarılmış nesneyi döndürür; seri durumdan çıkarılmaya çalışmadan önce seri hale getiricinin uygun bir öğeye konumlandırıldığını doğrulayıp doğrulamayacağını belirtmenize de olanak tanır.

ReadObject(XmlDictionaryReader)

JSON'dan eşlenen XML belgesini (JavaScript Nesne Gösterimi) ile XmlDictionaryReader okur ve seri durumdan çıkarılmış nesneyi döndürür.

ReadObject(XmlReader, Boolean)

JSON'dan eşlenen bir XML belgesini ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür; seri durumdan çıkarılmaya çalışmadan önce seri hale getiricinin uygun bir öğede konumlandırıldığını doğrulayıp doğrulamayacağını belirtmenizi de sağlar.

ReadObject(XmlReader)

JSON'dan eşlenen XML belgesini (JavaScript Nesne Gösterimi) ile XmlReader okur ve seri durumdan çıkarılmış nesneyi döndürür.

SetSerializationSurrogateProvider(ISerializationSurrogateProvider)

Serileştirme vekil sağlayıcısını ayarlar.

ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
WriteEndObject(XmlDictionaryWriter)

JavaScript Nesne Gösterimi (JSON) ile eşlenebilen bir kullanarak kapanış XML öğesini bir XmlDictionaryWriterXML belgesine yazar.

WriteEndObject(XmlWriter)

JavaScript Nesne Gösterimi (JSON) ile eşlenebilen bir kullanarak kapanış XML öğesini bir XmlWriterXML belgesine yazar.

WriteObject(Stream, Object)

Belirtilen nesneyi JavaScript Nesne Gösterimi (JSON) verilerine serileştirir ve sonuçta elde edilen JSON'u bir akışa yazar.

WriteObject(XmlDictionaryWriter, Object)

JavaScript Nesne Gösterimi (JSON) ile eşlenebilen bir nesneyi XML'ye serileştirir. Başlangıç XML öğesi, içerik ve kapanış öğesi de dahil olmak üzere tüm nesne verilerini ile XmlDictionaryWriteryazar.

WriteObject(XmlWriter, Object)

JavaScript Nesne Gösterimi (JSON) ile eşlenebilen bir nesneyi XML'ye serileştirir. Başlangıç XML öğesi, içerik ve kapanış öğesi de dahil olmak üzere tüm nesne verilerini ile XmlWriteryazar.

WriteObjectContent(XmlDictionaryWriter, Object)

Kullanarak XmlDictionaryWriterJavaScript Nesne Gösterimi'ne (JSON) eşlenebilen XML içeriğini yazar.

WriteObjectContent(XmlWriter, Object)

Kullanarak XmlWriterJavaScript Nesne Gösterimi'ne (JSON) eşlenebilen XML içeriğini yazar.

WriteStartObject(XmlDictionaryWriter, Object)

Kullanarak JavaScript Nesne Gösterimi'ne (JSON) XmlDictionaryWritereşlenebilen bir nesneyi XML'ye seri hale getirmek için açılış XML öğesini yazar.

WriteStartObject(XmlWriter, Object)

Kullanarak JavaScript Nesne Gösterimi'ne (JSON) XmlWritereşlenebilen bir nesneyi XML'ye seri hale getirmek için açılış XML öğesini yazar.

Şunlara uygulanır