DataContractSerializer Třída

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

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

Zdroj:

DataContractSerializer.cs

Serializuje a deserializuje instanci typu do datového proudu XML nebo dokumentu pomocí zadaného datového kontraktu. Tato třída se nemůže dědit.

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

Dědičnost

Object

XmlObjectSerializer

DataContractSerializer

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky k rozhraní API pro DataContractSerializer.

Konstruktory

Name	Description
DataContractSerializer(Type, DataContractSerializerSettings)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a nastavení.
DataContractSerializer(Type, IEnumerable<Type>)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu a kolekce známých typů, které mohou být přítomné v objektovém grafu.
DataContractSerializer(Type, String, String, IEnumerable<Type>)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou řetězcových parametrech a také seznam známých typů, které mohou být přítomné v objektovém grafu.
DataContractSerializer(Type, String, String)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí zadaného elementu XML kořenového elementu a oboru názvů.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje kořenový element XML a obor názvů ve dvou XmlDictionaryString parametrech a také seznam známých typů, které mohou být přítomny v objektovém grafu.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí kořenového elementu XML a oboru názvů určeného prostřednictvím parametrů typu XmlDictionaryString.
DataContractSerializer(Type)	Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu.

Vlastnosti

Name	Description
DataContractResolver	Získá komponentu použitou k dynamické mapování xsi:type deklarací na známé typy kontraktů.
IgnoreExtensionDataObject	Získá hodnotu, která určuje, zda má ignorovat data poskytnutá rozšířením třídy, když třída je serializována nebo deserializována.
KnownTypes	Získá kolekci typů, které mohou být přítomny v objekt grafu serializované pomocí této instance DataContractSerializer.
MaxItemsInObjectGraph	Získá maximální počet položek v grafu objektu serializovat nebo deserializovat.
PreserveObjectReferences	Získá hodnotu, která určuje, zda použít nestandardní xml konstrukty pro zachování objektu odkaz data.
SerializeReadOnlyTypes	Získá hodnotu, která určuje, zda jsou typy jen pro čtení serializovány.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsStartObject(XmlDictionaryReader)	Určuje, zda je umístěn XmlDictionaryReader na objektu, který lze deserializovat.
IsStartObject(XmlReader)	Určuje, zda je umístěn XmlReader na objektu, který lze deserializovat.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ReadObject(Stream)	Načte datový proud XML nebo dokument s deserializovaným objektem Stream a vrátí. (Zděděno od XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Přečte dokument XML nebo datový proud dokumentu a vrátí deserializovaný objekt. Metoda obsahuje parametr, který určuje, jestli je ověřený název objektu, a překladač pro mapování xsi:type deklarací za běhu.
ReadObject(XmlDictionaryReader, Boolean)	Načte datový proud XML s deserializovaným objektem XmlDictionaryReader a také určuje, zda je provedena kontrola ověření názvu objektu před přečtením jeho hodnoty.
ReadObject(XmlDictionaryReader)	Přečte dokument XML nebo datový proud s deserializovaným objektem XmlDictionaryReader a vrátí deserializovaný objekt. (Zděděno od XmlObjectSerializer)
ReadObject(XmlReader, Boolean)	Načte datový proud XML s deserializovaným objektem XmlReader a také určuje, zda je provedena kontrola ověření názvu objektu před přečtením jeho hodnoty.
ReadObject(XmlReader)	Načte datový proud XML s deserializovaným objektem XmlReader a vrátí ho.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
WriteEndObject(XmlDictionaryWriter)	Zapíše zavírací element XML pomocí znaku XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Zapíše zavírací element XML pomocí znaku XmlWriter.
WriteObject(Stream, Object)	Zapíše úplný obsah (začátek, obsah a konec) objektu do dokumentu XML nebo datového proudu se zadaným Stream. (Zděděno od XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)	Zapíše všechna data objektu (spuštění elementu XML, obsahu a ohraničující element) do dokumentu XML nebo datového proudu pomocí zadaného XmlDictionaryWriter. Tato metoda obsahuje překladač pro mapování xsi:type deklarací za běhu.
WriteObject(XmlDictionaryWriter, Object)	Zapíše úplný obsah (začátek, obsah a konec) objektu do dokumentu XML nebo datového proudu se zadaným XmlDictionaryWriter. (Zděděno od XmlObjectSerializer)
WriteObject(XmlWriter, Object)	Zapíše všechna data objektu (spuštění elementu XML, obsahu a uzavření elementu) do dokumentu XML nebo datového proudu pomocí XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Zapíše obsah XML pomocí .XmlDictionaryWriter
WriteObjectContent(XmlWriter, Object)	Zapíše obsah XML pomocí .XmlWriter
WriteStartObject(XmlDictionaryWriter, Object)	Zapíše levý element XML pomocí znaku XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Zapíše levý element XML pomocí znaku XmlWriter.

Metody rozšíření

Name	Description
GetSerializationSurrogateProvider(DataContractSerializer)	Vrátí náhradního zprostředkovatele serializace pro tento serializátor.
SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)	Určuje náhradního zprostředkovatele serializace pro toto DataContractSerializer.

Bezpečný přístup z více vláken

Instance této třídy jsou bezpečné pro vlákna s výjimkou případů, kdy je instance použita s implementací IDataContractSurrogate nebo DataContractResolver.

Viz také

• DataMemberAttribute
• DataContractAttribute
• IExtensibleDataObject
• ExtensionDataObject
• Použití kontraktů dat
• Serializace a deserializace