DataContractSerializer Classe

Définition

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
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, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, et un substitut pour la sérialisation personnalisée.

DataContractSerializer(Type, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

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, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, ainsi que l'élément et l'espace de noms XML qui incluent le contenu.

DataContractSerializer(Type, String, String, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

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.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer les données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, et les paramètres XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contiennent le contenu.

DataContractSerializer(Type, XmlDictionaryString, XmlDictionaryString, IEnumerable<Type>, Int32, Boolean, Boolean, IDataContractSurrogate, DataContractResolver)

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 une liste des types connus qui peuvent être présents dans le graphique d'objets, le nombre maximal d'éléments de graphique à sérialiser, les paramètres pour ignorer des données inattendues, s'il faut utiliser des constructions XML non standard pour conserver les données de référence d'objet dans le graphique, un substitut pour la sérialisation personnalisée, les paramètres de XmlDictionaryString qui spécifient l'élément et l'espace de noms XML qui contient le contenu, ainsi qu'une autre approche pour mapper des déclarations xsi:type au moment de l'exécution.

Propriétés

DataContractResolver

Obtient le composant utilisé pour mapper dynamiquement les déclarations xsi:type aux types de contrat connus.

DataContractSurrogate

Obtient un type de substitut capable d’étendre le processus de sérialisation ou de désérialisation.

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.

S’applique à

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