DataContractJsonSerializer Osztály

Definíció

Névtér:

System.Runtime.Serialization.Json

Szerelvények:

netstandard.dll, System.Runtime.Serialization.Json.dll

Forrás:

DataContractJsonSerializer.cs

Szerializálja az objektumokat a JavaScript Object Notation (JSON) számára, és deszerializálja a JSON-adatokat az objektumokra. Ez az osztály nem örökölhető.

public ref class DataContractJsonSerializer sealed : System::Runtime::Serialization::XmlObjectSerializer

public sealed class DataContractJsonSerializer : System.Runtime.Serialization.XmlObjectSerializer

type DataContractJsonSerializer = class
    inherit XmlObjectSerializer

Public NotInheritable Class DataContractJsonSerializer
Inherits XmlObjectSerializer

Öröklődés

Object

XmlObjectSerializer

DataContractJsonSerializer

Megjegyzések

A legtöbb olyan forgatókönyv esetében, amely magában foglalja a JSON-ba való szerializálást és a JSON-ból való deszerializálást, javasoljuk a System.Text.Json névtér API-jait.

Ha a forgatókönyv megköveteli az DataContractJsonSerializer osztályt, használhatja egy típuspéldányok JSON-dokumentummá való szerializálására, valamint egy JSON-dokumentum típuspéldánysá való deszerializálására. Létrehozhat például egy olyan típust, amely alapvető adatokat, például nevet és címet tartalmazó tulajdonságokkal rendelkezik Person . Ezután létrehozhatja és módosíthatja az Person osztály egy példányát, és az összes tulajdonságértékét megírhatja egy JSON-dokumentumban későbbi lekérés céljából. Ez a JSON-dokumentum később deszerializálható az Person osztályba vagy egy másik, egyenértékű adatszerződéssel rendelkező osztályba.

Ha hiba történik egy kimenő válasz szerializálása során a kiszolgálón, vagy a válaszművelet kivételt okoz valamilyen más okból, előfordulhat, hogy a rendszer nem kapja vissza az ügyfelet hibaként.

Konstruktorok

Name	Description
DataContractJsonSerializer(Type, DataContractJsonSerializerSettings)	Inicializálja az osztály új példányát, DataContractJsonSerializer hogy szerializáljon vagy deszerializáljon egy objektumot a megadott típusú és szerializáló beállításokkal.
DataContractJsonSerializer(Type, IEnumerable<Type>)	Inicializálja az osztály új példányát a DataContractJsonSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához, az objektumgráfban esetleg megtalálható ismert típusok gyűjteményével.
DataContractJsonSerializer(Type, String, IEnumerable<Type>)	Inicializálja az DataContractJsonSerializer osztály új példányát, hogy szerializáljon vagy deszerializáljon egy adott típusú objektumot a paraméter által megadott XML-gyökérelem használatával, az objektumgráfban esetleg megtalálható ismert típusok gyűjteményével.
DataContractJsonSerializer(Type, String)	Inicializálja az DataContractJsonSerializer osztály új példányát egy adott típusú objektum szerializálásához vagy deszerializálásához a paraméter által megadott XML-gyökérelem használatával.
DataContractJsonSerializer(Type, XmlDictionaryString, IEnumerable<Type>)	Inicializálja az DataContractJsonSerializer osztály új példányát, hogy szerializáljon vagy deszerializáljon egy adott típusú objektumot egy adott típusú XmlDictionaryStringparaméter által megadott XML-gyökérelem használatával, az objektumgráfban esetleg megtalálható ismert típusok gyűjteményével.
DataContractJsonSerializer(Type, XmlDictionaryString)	Inicializálja az DataContractJsonSerializer osztály új példányát egy adott típusú objektum szerializálásához vagy deszerializálásához a típusparaméter XmlDictionaryStringáltal megadott XML-gyökérelem használatával.
DataContractJsonSerializer(Type)	Inicializálja az osztály új példányát a DataContractJsonSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához.

Tulajdonságok

Name	Description
DateTimeFormat	Lekéri az objektumdiagram dátum- és időtípus-elemeinek formátumát.
EmitTypeInformation	Lekéri vagy beállítja az adatszerződés JSON szerializáló beállításait, hogy típusadatokat bocsátson ki.
IgnoreExtensionDataObject	Olyan értéket kap, amely meghatározza, hogy az ismeretlen adatok figyelmen kívül lesznek-e hagyva a deszerializálás során, és hogy a rendszer figyelmen kívül hagyja-e a IExtensibleDataObject felületet a szerializálás során.
KnownTypes	Lekéri a típusok gyűjteményét, amelyek jelen lehetnek az objektumgráfban szerializálva az DataContractJsonSerializeradott példány használatával.
MaxItemsInObjectGraph	Lekéri egy objektumdiagram azon elemeinek maximális számát, amelyeket a szerializáló szerializál vagy deszerializál egy olvasási vagy írási hívásban.
SerializeReadOnlyTypes	Lekéri vagy beállít egy értéket, amely meghatározza, hogy csak olvasási típusokat szerializáljon-e.
UseSimpleDictionaryFormat	Olyan értéket kap, amely meghatározza, hogy egyszerű szótárformátumot használjon-e.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetSerializationSurrogateProvider()	Lekéri az aktuális szerializálási helyettesítő szolgáltatót.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsStartObject(XmlDictionaryReader)	Olyan értéket kap, amely meghatározza, hogy a XmlDictionaryReader szerializáló által deszerializálható objektumot képviselő XML-elem fölé van-e helyezve.
IsStartObject(XmlReader)	Meghatározza, hogy az XmlReader objektum egy deszerializálható objektumon van-e elhelyezve.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ReadObject(Stream)	Beolvassa a dokumentumfolyamot JSON (JavaScript Object Notation) formátumban, és visszaadja a deszerializált objektumot.
ReadObject(XmlDictionaryReader, Boolean)	Beolvassa a JSON-ból leképezett XML-dokumentumot, XmlDictionaryReader és visszaadja a deszerializált objektumot. Azt is megadhatja, hogy a szerializálónak ellenőriznie kell-e, hogy a megfelelő elemen van-e elhelyezve a deszerializálási kísérlet előtt.
ReadObject(XmlDictionaryReader)	Beolvassa a JSON-ból (JavaScript Object Notation) leképezett XML-dokumentumot egy XmlDictionaryReader deszerializált objektummal, és visszaadja azt.
ReadObject(XmlReader, Boolean)	Beolvassa a JSON-ból leképezett XML-dokumentumot, XmlReader és visszaadja a deszerializált objektumot. Azt is megadhatja, hogy a szerializálónak ellenőriznie kell-e, hogy a megfelelő elemen van-e elhelyezve a deszerializálási kísérlet előtt.
ReadObject(XmlReader)	Beolvassa a JSON-ból (JavaScript Object Notation) leképezett XML-dokumentumot egy XmlReader deszerializált objektummal, és visszaadja azt.
SetSerializationSurrogateProvider(ISerializationSurrogateProvider)	Beállítja a szerializáció helyettesítő szolgáltatót.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
WriteEndObject(XmlDictionaryWriter)	A záró XML-elemet egy XML-dokumentumba írja egy XmlDictionaryWriter, a JavaScript Object Notationra (JSON) leképezhető elemet használva.
WriteEndObject(XmlWriter)	A záró XML-elemet egy XML-dokumentumba írja egy XmlWriter, a JavaScript Object Notationra (JSON) leképezhető elemet használva.
WriteObject(Stream, Object)	Szerializál egy megadott objektumot a JavaScript Object Notation (JSON) adataihoz, és az eredményként kapott JSON-t egy streambe írja.
WriteObject(XmlDictionaryWriter, Object)	Szerializál egy objektumot XML-fájlba, amely a JavaScript Object Notation (JSON) kifejezésre képezhető le. Az összes objektumadatot megírja, beleértve a kezdő XML-elemet, a tartalmat és a záró elemet egy XmlDictionaryWriter.
WriteObject(XmlWriter, Object)	Szerializál egy objektumot XML-fájlba, amely a JavaScript Object Notation (JSON) kifejezésre képezhető le. Az összes objektumadatot megírja, beleértve a kezdő XML-elemet, a tartalmat és a záró elemet egy XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	A JavaScript Object Notationra (JSON) leképezhető XML-tartalmat egy XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	A JavaScript Object Notationra (JSON) leképezhető XML-tartalmat egy XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Megírja a nyitó XML-elemet egy objektum XML-fájlba való szerializálásához, amely a JavaScript Object Notationra (JSON) képezhető le egy XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Megírja a nyitó XML-elemet egy objektum XML-fájlba való szerializálásához, amely a JavaScript Object Notationra (JSON) képezhető le egy XmlWriter.