DataContractSerializer Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Serializuje a deserializuje instanci typu do datového proudu XML nebo dokumentu pomocí zadaného kontraktu dat. Tato třída se nemůže dědit.
public ref class DataContractSerializer sealed : System::Runtime::Serialization::XmlObjectSerializerpublic sealed class DataContractSerializer : System.Runtime.Serialization.XmlObjectSerializertype DataContractSerializer = class
inherit XmlObjectSerializerPublic NotInheritable Class DataContractSerializer
Inherits XmlObjectSerializer- Dědičnost
Poznámky
Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro DataContractSerializer.
Konstruktory
| DataContractSerializer(Type) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. |
| 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 kolekci známých typů, které mohou být přítomny v grafu objektů. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu serializovat, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat objektu v grafu, a náhradu pro vlastní serializaci. |
| DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu serializovat, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat objektu v grafu, náhradní pro vlastní serializaci a alternativu pro mapování |
| DataContractSerializer(Type, String, String) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu pomocí zadaného kořenového elementu XML a oboru názvů. |
| 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, stejně jako seznam známých typů, které mohou být přítomny v grafu objektů. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu serializovat, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat objektu v grafu, náhradní pro vlastní serializaci a xml element a obor názvů, které obsahují obsah. |
| DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které se můžou vyskytovat v objektovém grafu, maximální počet položek grafu, které se mají serializovat, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat na objekty v grafu, náhradní pro vlastní serializaci, element XML a obor názvů, který obsahuje obsah. a alternativu pro mapování |
| 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ů zadaného prostřednictvím parametrů typu XmlDictionaryString. |
| 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, stejně jako seznam známých typů, které mohou být přítomny v grafu objektů. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které mohou být přítomny v objektovém grafu, maximální počet položek grafu k serializaci, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat objektu v grafu, náhradní pro vlastní serializaci a parametry XmlDictionaryString , které určují xml element a obor názvů, které obsahují obsah. |
| DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver) |
Inicializuje novou instanci DataContractSerializer třídy serializovat nebo deserializovat objekt zadaného typu. Tato metoda také určuje seznam známých typů, které se můžou vyskytovat v grafu objektů, maximální počet položek grafu, které se mají serializovat, parametry pro ignorování neočekávaných dat, zda se mají použít nestandardní konstrukce XML k zachování referenčních dat objektů v grafu, náhradní pro vlastní serializaci, parametry XmlDictionaryString , které určují element XML a obor názvů, který obsahuje obsah, a alternativu pro mapování |
Vlastnosti
| DataContractResolver |
Získá komponentu použitou k dynamickému mapování |
| DataContractSurrogate |
Získá náhradní typ, který může rozšířit serializace nebo deserializace procesu. |
| IgnoreExtensionDataObject |
Získá hodnotu, která určuje, zda ignorovat data poskytnutá rozšířením třídy při serializaci nebo deserializaci třídy. |
| KnownTypes |
Získá kolekci typů, které mohou být přítomny v grafu objektu 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 konstruktorů zachovat odkaz data objektu. |
| SerializeReadOnlyTypes |
Získá hodnotu, která určuje, zda jsou serializovány typy jen pro čtení. |
Metody
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| IsStartObject(XmlDictionaryReader) |
Určuje, zda XmlDictionaryReader je umístěn na objekt, který lze deserializovat. |
| IsStartObject(XmlReader) |
Určuje, zda XmlReader je umístěn na objekt, který lze deserializovat. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ReadObject(Stream) |
Přečte datový proud XML nebo dokument s Stream a vrátí deserializovaný objekt. (Zděděno od XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader) |
Načte dokument XML nebo datový proud s a XmlDictionaryReader vrátí deserializovaný objekt. (Zděděno od XmlObjectSerializer) |
| ReadObject(XmlDictionaryReader, Boolean) |
Načte datový proud XML s a XmlDictionaryReader vrátí deserializovaný objekt a také určuje, zda je provedena kontrola k ověření názvu objektu před čtením jeho hodnoty. |
| ReadObject(XmlDictionaryReader, Boolean, DataContractResolver) |
Načte dokument XML nebo datový proud dokumentu a vrátí deserializovaný objekt. Metoda obsahuje parametr určující, zda je název objektu ověřený, a překladač pro mapování |
| ReadObject(XmlReader) |
Načte datový proud XML s a XmlReader vrátí deserializovaný objekt. |
| ReadObject(XmlReader, Boolean) |
Načte datový proud XML s a XmlReader vrátí deserializovaný objekt a také určuje, zda je provedena kontrola k ověření názvu objektu před čtením jeho hodnoty. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| WriteEndObject(XmlDictionaryWriter) |
Zapíše uzavírací element XML pomocí XmlDictionaryWriter. |
| WriteEndObject(XmlWriter) |
Zapíše uzavírací element XML pomocí XmlWriter. |
| WriteObject(Stream, Object) |
Zapíše úplný obsah (začátek, obsah a konec) objektu do dokumentu XML nebo datového proudu se zadaným Streamobjektem . (Zděděno od XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object) |
Zapíše úplný obsah (začátek, obsah a konec) objektu do dokumentu XML nebo datového proudu se zadaným XmlDictionaryWriterobjektem . (Zděděno od XmlObjectSerializer) |
| WriteObject(XmlDictionaryWriter, Object, DataContractResolver) |
Zapíše všechna data objektu (počáteční XML element, obsah a ohraničující prvek) do xml dokumentu nebo streamu pomocí zadané XmlDictionaryWriter. Metoda obsahuje překladač pro mapování |
| WriteObject(XmlWriter, Object) |
Zapíše všechna data objektu (počínaje elementem XML, obsahem a ukončovacím elementem) do dokumentu XML nebo datového XmlWriterproudu pomocí . |
| WriteObjectContent(XmlDictionaryWriter, Object) |
Zapíše obsah XML pomocí .XmlDictionaryWriter |
| WriteObjectContent(XmlWriter, Object) |
Zapíše obsah XML pomocí .XmlWriter |
| WriteStartObject(XmlDictionaryWriter, Object) |
Zapíše počáteční element XML pomocí XmlDictionaryWriter. |
| WriteStartObject(XmlWriter, Object) |
Zapíše počáteční element XML pomocí XmlWriter. |
Metody rozšíření
| 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 tento DataContractSerializer. |
Platí pro
Bezpečný přístup z více vláken
Instance této třídy jsou bezpečné z více vláken s výjimkou případů, kdy se instance používá s implementací IDataContractSurrogate nebo DataContractResolver.
