DataContractSerializer Osztály

Definíció

Névtér:

System.Runtime.Serialization

Szerelvények:

netstandard.dll, System.Runtime.Serialization.Xml.dll

Forrás:

DataContractSerializer.cs

Egy adott típusú példány szerializálása és deszerializálása XML-adatfolyamba vagy -dokumentumba egy megadott adatszerződés használatával. Ez az osztály nem örökölhető.

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

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

type DataContractSerializer = class
    inherit XmlObjectSerializer

Public NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer

Öröklődés

Object

XmlObjectSerializer

DataContractSerializer

Megjegyzések

Az API-val kapcsolatos további információkért lásd a DataContractSerializer kiegészítő API-megjegyzéseit.

Konstruktorok

Name	Description
DataContractSerializer(Type, DataContractSerializerSettings)	Inicializálja az osztály új példányát, DataContractSerializer hogy szerializáljon vagy deszerializáljon egy adott típusú és beállítású objektumot.
DataContractSerializer(Type, IEnumerable<Type>)	Inicializálja az osztály új példányát a DataContractSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához, valamint az objektumgráfban esetleg megtalálható ismert típusok gyűjteményét.
DataContractSerializer(Type, String, String, IEnumerable<Type>)	Inicializálja az osztály új példányát a DataContractSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához. Ez a metódus két sztringparaméter gyökér XML-elemét és névterét, valamint az objektumgráfban esetleg megtalálható ismert típusok listáját is megadja.
DataContractSerializer(Type, String, String)	Inicializálja az osztály új példányát a DataContractSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához a megadott XML-gyökérelem és névtér használatával.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Inicializálja az osztály új példányát a DataContractSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához. Ez a metódus két XmlDictionaryString paraméter gyökér XML-elemét és névterét, valamint az objektumgráfban esetleg megtalálható ismert típusok listáját is megadja.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	Inicializálja az osztály új példányát, DataContractSerializer hogy szerializálja vagy deszerializálja a megadott típusú objektumot a típusparamétereken XmlDictionaryStringmegadott XML-gyökérelem és névtér használatával.
DataContractSerializer(Type)	Inicializálja az osztály új példányát a DataContractSerializer megadott típusú objektumok szerializálásához vagy deszerializálásához.

Tulajdonságok

Name	Description
DataContractResolver	Lekéri a deklarációk ismert szerződéstípusokhoz való dinamikus leképezéséhez xsi:type használt összetevőt.
IgnoreExtensionDataObject	Olyan értéket kap, amely meghatározza, hogy figyelmen kívül hagyja-e az osztály kiterjesztése által szolgáltatott adatokat az osztály szerializálása vagy deszerializálása során.
KnownTypes	Lekéri a típusok gyűjteményét, amelyek jelen lehetnek az objektumgráfban szerializálva az DataContractSerializeradott példány használatával.
MaxItemsInObjectGraph	Lekéri az objektumgráfban lévő elemek maximális számát szerializálni vagy deszerializálni.
PreserveObjectReferences	Olyan értéket kap, amely meghatározza, hogy nem szabványos XML-szerkezeteket használjon-e az objektumhivatkozási adatok megőrzéséhez.
SerializeReadOnlyTypes	Olyan értéket kap, amely meghatározza, hogy az írásvédett típusok szerializálva vannak-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)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsStartObject(XmlDictionaryReader)	Meghatározza, hogy az XmlDictionaryReader objektum egy deszerializálható objektumon van-e elhelyezve.
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 az XML-adatfolyamot vagy -dokumentumot a Stream deszerializált objektummal, és visszaadja. (Öröklődés forrása XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Beolvas egy XML-dokumentumot vagy dokumentumstreamet, és visszaadja a deszerializált objektumot. A metódus tartalmaz egy paramétert, amely meghatározza, hogy az objektumnév ellenőrzése megtörtént-e, és egy feloldó a futtatókörnyezetben lévő leképezési deklarációkhoz xsi:type .
ReadObject(XmlDictionaryReader, Boolean)	Beolvassa az XML-adatfolyamot egy XmlDictionaryReader és visszaadja a deszerializált objektumot, és azt is megadja, hogy a rendszer ellenőrzi-e az objektum nevét az érték elolvasása előtt.
ReadObject(XmlDictionaryReader)	Beolvassa az XML-dokumentumot vagy streamet egy XmlDictionaryReader deszerializált objektummal, és visszaadja azt. (Öröklődés forrása XmlObjectSerializer)
ReadObject(XmlReader, Boolean)	Beolvassa az XML-adatfolyamot egy XmlReader és visszaadja a deszerializált objektumot, és azt is megadja, hogy a rendszer ellenőrzi-e az objektum nevét az érték elolvasása előtt.
ReadObject(XmlReader)	Beolvassa az XML-adatfolyamot egy XmlReader és visszaadja a deszerializált objektumot.
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 XmlDictionaryWriter.
WriteEndObject(XmlWriter)	A záró XML-elemet egy XmlWriter.
WriteObject(Stream, Object)	Az objektum teljes tartalmát (kezdését, tartalmát és végét) a megadott StreamXML-dokumentumba vagy streambe írja. (Öröklődés forrása XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)	Az összes objektumadatot (kezdő XML-elemet, tartalmat és belefoglaló elemet) egy XML-dokumentumba vagy streambe írja a megadott XmlDictionaryWriter használatával. A metódus tartalmaz egy feloldót a futtatókörnyezetben lévő deklarációk leképezéséhez xsi:type .
WriteObject(XmlDictionaryWriter, Object)	Az objektum teljes tartalmát (kezdését, tartalmát és végét) a megadott XmlDictionaryWriterXML-dokumentumba vagy streambe írja. (Öröklődés forrása XmlObjectSerializer)
WriteObject(XmlWriter, Object)	Az összes objektumadatot (kezdő XML-elemet, tartalmat és záró elemet) egy XML-dokumentumba vagy streambe írja egy XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Az XML-tartalmat egy XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Az XML-tartalmat egy XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	A nyitó XML-elemet egy XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	A nyitó XML-elemet egy XmlWriter.

Bővítő metódusok

Name	Description
GetSerializationSurrogateProvider(DataContractSerializer)	A szerializáló helyettesítő szerializálási szolgáltatójának értékét adja vissza.
SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)	Egy helyettesítő szerializálási szolgáltatót ad meg ehhez DataContractSerializera .

Szálbiztonság

Az osztály példányai szálbiztosak, kivéve, ha a példányt az vagy IDataContractSurrogatea DataContractResolver .

Lásd még

• DataMemberAttribute
• DataContractAttribute
• IExtensibleDataObject
• ExtensionDataObject
• Adatszerződések használata
• Szerializálás és deszerializálás