DataContractSerializer Classe

Définition

Espace de noms:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Xml.dll

Source:

DataContractSerializer.cs

Sérialise et désérialise une instance d'un type dans un flux ou un document XML à l'aide d'un contrat de données fourni. Cette classe ne peut pas être héritée.

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

Héritage

Object

XmlObjectSerializer

DataContractSerializer

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour DataContractSerializer.

Constructeurs

DataContractSerializer(Type)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié.
DataContractSerializer(Type, DataContractSerializerSettings)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet avec le type et les paramètres spécifiés.
DataContractSerializer(Type, IEnumerable<Type>)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié, et une collection de types connus pouvant être présents dans le graphique d'objets.
DataContractSerializer(Type, String, String)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML fournis.
DataContractSerializer(Type, String, String, IEnumerable<Type>)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres de chaîne ainsi qu'une liste des types connus pouvant être présents dans le graphique d'objets.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié à l'aide de l'élément racine et de l'espace de noms XML spécifiés dans les paramètres de type XmlDictionaryString.
DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>)	Initialise une nouvelle instance de la classe DataContractSerializer pour sérialiser ou désérialiser un objet du type spécifié. Cette méthode spécifie également l'élément XML racine et l'espace de noms dans deux paramètres XmlDictionaryString ainsi qu'une liste de types connus pouvant être présents dans le graphique d'objets.

Propriétés

DataContractResolver	Obtient le composant utilisé pour mapper dynamiquement les déclarations xsi:type aux types de contrat connus.
IgnoreExtensionDataObject	Obtient une valeur qui spécifie s'il faut ignorer les données fournies par une extension de la classe lors de la sérialisation ou la désérialisation de la classe.
KnownTypes	Obtient une collection des types pouvant être présents dans le graphique d'objets sérialisé à l'aide de cette instance de DataContractSerializer.
MaxItemsInObjectGraph	Obtient le nombre maximal d'éléments à sérialiser ou désérialiser dans un graphique d'objets.
PreserveObjectReferences	Obtient une valeur qui spécifie s'il faut utiliser des constructions XML non standard pour conserver des données de référence d'objet.
SerializeReadOnlyTypes	Obtient une valeur qui spécifie si les types en lecture seule sont sérialisés.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsStartObject(XmlDictionaryReader)	Détermine si la classe XmlDictionaryReader est positionnée sur un objet pouvant être désérialisé.
IsStartObject(XmlReader)	Détermine si la classe XmlReader est positionnée sur un objet pouvant être désérialisé.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ReadObject(Stream)	Lit le flux ou le document XML avec un Stream et retourne l'objet désérialisé. (Hérité de XmlObjectSerializer)
ReadObject(XmlDictionaryReader)	Lit le document ou le flux XML avec un XmlDictionaryReader et retourne l'objet désérialisé. (Hérité de XmlObjectSerializer)
ReadObject(XmlDictionaryReader, Boolean)	Lit le flux XML avec une classe XmlDictionaryReader et retourne l'objet désérialisé. Il spécifie également si un contrôle doit être effectué pour vérifier le nom de l'objet avant de lire sa valeur.
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Lit un document XML ou un flux de document et retourne l'objet désérialisé. La méthode contient un paramètre pour spécifier si le nom d'objet est vérifié et validé, et un programme de résolution pour le mappage de déclarations xsi:type au moment de l'exécution.
ReadObject(XmlReader)	Lit le flux XML avec une classe XmlReader et retourne l'objet désérialisé.
ReadObject(XmlReader, Boolean)	Lit le flux XML avec une classe XmlReader et retourne l'objet désérialisé. Il spécifie également si un contrôle doit être effectué pour vérifier le nom de l'objet avant de lire sa valeur.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
WriteEndObject(XmlDictionaryWriter)	Écrit l'élément XML de fermeture à l'aide d'une classe XmlDictionaryWriter.
WriteEndObject(XmlWriter)	Écrit l'élément XML de fermeture à l'aide d'une classe XmlWriter.
WriteObject(Stream, Object)	Écrit le contenu complet (début, contenu et fin) de l'objet dans le flux ou le document XML avec le Stream spécifié. (Hérité de XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object)	Écrit le contenu complet (début, contenu et fin) de l'objet dans le flux ou le document XML avec le XmlDictionaryWriter spécifié. (Hérité de XmlObjectSerializer)
WriteObject(XmlDictionaryWriter, Object, DataContractResolver)	Écrit toutes les données d’objet (élément XML de départ, contenu et élément englobant) dans un document ou un flux XML à l’aide du XmlDictionaryWriter spécifié. La méthode inclut un programme de résolution pour le mappage de déclarations xsi:type au moment de l'exécution.
WriteObject(XmlWriter, Object)	Écrit toutes les données d'objet (élément XML de début, de contenu et de fermeture) dans un document ou un flux XML avec une classe XmlWriter.
WriteObjectContent(XmlDictionaryWriter, Object)	Écrit le contenu XML à l'aide d'une classe XmlDictionaryWriter.
WriteObjectContent(XmlWriter, Object)	Écrit le contenu XML à l'aide d'une classe XmlWriter.
WriteStartObject(XmlDictionaryWriter, Object)	Écrit l'élément XML d'ouverture à l'aide d'une classe XmlDictionaryWriter.
WriteStartObject(XmlWriter, Object)	Écrit l'élément XML d'ouverture à l'aide d'une classe XmlWriter.

Méthodes d’extension

GetSerializationSurrogateProvider(DataContractSerializer)	Retourne le substitut de fournisseur de sérialisation pour ce sérialiseur.
SetSerializationSurrogateProvider(DataContractSerializer, ISerializationSurrogateProvider)	Spécifie un fournisseur de sérialisation de substitution pour ce DataContractSerializer.

Cohérence de thread

Les instances de cette classe sont thread-safe, sauf lorsque le instance est utilisé avec une implémentation de ou IDataContractSurrogateDataContractResolver.

Voir aussi

• DataMemberAttribute
• DataContractAttribute
• IExtensibleDataObject
• ExtensionDataObject
• Utilisation de contrats de données
• Sérialisation et désérialisation