System.Runtime.Serialization Namespace

L'espace de noms System.Runtime.Serialization contient des classes qui peuvent être utilisées pour sérialiser et désérialiser des objets. The System.Runtime.Serialization namespace contains classes that can be used for serializing and deserializing objects. La sérialisation est le processus de conversion d'un objet ou d'un graphique d'objets en séquence linéaire d'octets pour stockage ou transmission à un autre emplacement. Serialization is the process of converting an object or a graph of objects into a linear sequence of bytes for either storage or transmission to another location. La désérialisation est le processus consistant à prendre des informations stockées et à recréer des objets à partir de celles-ci. Deserialization is the process of taking in stored information and recreating objects from it.

Classes

CollectionDataContractAttribute

En cas d'application à un type collection, active la spécification personnalisée des éléments item de la collection.When applied to a collection type, enables custom specification of the collection item elements. Cet attribut peut uniquement être appliqué aux types qui sont reconnus comme étant des collections valides et sérialisables par le DataContractSerializer.This attribute can be applied only to types that are recognized by the DataContractSerializer as valid, serializable collections.

ContractNamespaceAttribute

Spécifie l'espace de noms CLR et l'espace de noms XML du contrat de données.Specifies the CLR namespace and XML namespace of the data contract.

DataContractAttribute

Spécifie que le type définit ou implémente un contrat de données et qu'il est sérialisable par un sérialiseur, tel que le DataContractSerializer.Specifies that the type defines or implements a data contract and is serializable by a serializer, such as the DataContractSerializer. Pour rendre un type sérialisable, les auteurs de types doivent définir un contrat de données pour ce type.To make their type serializable, type authors must define a data contract for their type.

DataContractResolver

Fournit un mécanisme pour mapper dynamiquement des types vers et à partir de représentations xsi:type pendant la sérialisation et la désérialisation.Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

DataContractSerializer

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.Serializes and deserializes an instance of a type into an XML stream or document using a supplied data contract. Cette classe ne peut pas être héritée.This class cannot be inherited.

DataContractSerializerExtensions

Étend la classe DataContractSerializer en fournissant des méthodes pour définir et obtenir un ISerializationSurrogateProvider.Extends the DataContractSerializer class by providing methods for setting and getting an ISerializationSurrogateProvider.

DataContractSerializerSettings

Spécifie les paramètres de sérialiseur du contrat de données.Specifies data contract serializer settings.

DataMemberAttribute

Lors de l'application au membre d'un type, spécifie que le membre fait partie d'un contrat de données et qu'il est sérialisable par le DataContractSerializer.When applied to the member of a type, specifies that the member is part of a data contract and is serializable by the DataContractSerializer.

DateTimeFormat

Spécifie les options du format de date/heure.Specifies date-time format options.

EnumMemberAttribute

Spécifie que le champ est un membre d'énumération et qu'il doit être sérialisé.Specifies that the field is an enumeration member and should be serialized.

ExportOptions

Représente les options qui peuvent être définies pour une classe XsdDataContractExporter.Represents the options that can be set for an XsdDataContractExporter.

ExtensionDataObject

Stocke des données provenant d'un contrat de données dont les versions sont gérées, qui a été étendu en ajoutant de nouveaux membres.Stores data from a versioned data contract that has been extended by adding new members.

Formatter

Fournit la fonctionnalité de base pour les formateurs de sérialisation du Common Language Runtime.Provides base functionality for the common language runtime serialization formatters.

FormatterConverter

Représente une implémentation de base de l'interface IFormatterConverter qui utilise la classe Convert et l'interface IConvertible.Represents a base implementation of the IFormatterConverter interface that uses the Convert class and the IConvertible interface.

FormatterServices

Fournit des méthodes statiques pour faciliter l'implémentation de Formatter pour la sérialisation.Provides static methods to aid with the implementation of a Formatter for serialization. Cette classe ne peut pas être héritée.This class cannot be inherited.

IgnoreDataMemberAttribute

En cas d'application au membre d'un type, précise que le membre ne fait pas partie d'un contrat de données et n'est pas sérialisé.When applied to the member of a type, specifies that the member is not part of a data contract and is not serialized.

ImportOptions

Représente les options qui peuvent être définies sur un XsdDataContractImporter.Represents the options that can be set on an XsdDataContractImporter.

InvalidDataContractException

L'exception qui est levée lorsque le DataContractSerializer ou le NetDataContractSerializer rencontre un contrat de données non valide lors de la sérialisation et de la désérialisation.The exception that is thrown when the DataContractSerializer or NetDataContractSerializer encounters an invalid data contract during serialization and deserialization.

KnownTypeAttribute

Spécifie les types qui doivent être reconnus par le DataContractSerializer lors de la sérialisation ou de la désérialisation d'un type donné.Specifies types that should be recognized by the DataContractSerializer when serializing or deserializing a given type.

NetDataContractSerializer

Sérialise et désérialise une instance d’un type dans un flux ou un document XML à l’aide des types .NET Framework fournis.Serializes and deserializes an instance of a type into XML stream or document using the supplied .NET Framework types. Cette classe ne peut pas être héritée.This class cannot be inherited.

ObjectIDGenerator

Génère des ID pour des objets.Generates IDs for objects.

ObjectManager

Assure le suivi des objets lors de leur désérialisation.Keeps track of objects as they are deserialized.

OnDeserializedAttribute

En cas d'application à une méthode, spécifie que celle-ci est appelée immédiatement après la désérialisation d'un objet dans un graphique d'objets.When applied to a method, specifies that the method is called immediately after deserialization of an object in an object graph. L’ordre de désérialisation par rapport aux autres objets dans le graphique est non déterministe.The order of deserialization relative to other objects in the graph is non-deterministic.

OnDeserializingAttribute

En cas d’application à une méthode, spécifie que la méthode est appelée pendant la désérialisation d’un objet dans un graphique d’objet.When applied to a method, specifies that the method is called during deserialization of an object in an object graph. L’ordre de désérialisation par rapport aux autres objets dans le graphique est non déterministe.The order of deserialization relative to other objects in the graph is non-deterministic.

OnSerializedAttribute

En cas d'application à une méthode, spécifie que la méthode est appelée après la sérialisation d'un objet dans un graphique d'objet.When applied to a method, specifies that the method is called after serialization of an object in an object graph. L'ordre de sérialisation par rapport aux autres objets dans le graphique est non déterministe.The order of serialization relative to other objects in the graph is non-deterministic.

OnSerializingAttribute

En cas d'application à une méthode, spécifie que la méthode est appelée pendant la sérialisation d'un objet dans un graphique d'objet.When applied to a method, specifies that the method is during serialization of an object in an object graph. L'ordre de sérialisation par rapport aux autres objets dans le graphique est non déterministe.The order of serialization relative to other objects in the graph is non-deterministic.

OptionalFieldAttribute

Spécifie qu'un champ peut être absent d'un flux de sérialisation afin que BinaryFormatter et SoapFormatter ne lèvent pas d'exception.Specifies that a field can be missing from a serialization stream so that the BinaryFormatter and the SoapFormatter does not throw an exception.

SafeSerializationEventArgs

Fournit des données pour l'événement SerializeObjectState.Provides data for the SerializeObjectState event.

SerializationBinder

Permet aux utilisateurs de contrôler le chargement de classe et de sélectionner la classe à charger.Allows users to control class loading and mandate what class to load.

SerializationException

Exception levée lorsqu'une erreur se produit pendant une opération de sérialisation ou de désérialisation.The exception thrown when an error occurs during serialization or deserialization.

SerializationInfo

Stocke toutes les données nécessaires pour sérialiser ou désérialiser un objet.Stores all the data needed to serialize or deserialize an object. Cette classe ne peut pas être héritée.This class cannot be inherited.

SerializationInfoEnumerator

Fournit un mécanisme simplifié pour le formateur permettant d'analyser des données dans SerializationInfo.Provides a formatter-friendly mechanism for parsing the data in SerializationInfo. Cette classe ne peut pas être héritée.This class cannot be inherited.

SerializationObjectManager

Gère des processus de sérialisation au moment de l'exécution.Manages serialization processes at run time. Cette classe ne peut pas être héritée.This class cannot be inherited.

SurrogateSelector

Assiste les formateurs lors de la sélection du substitut de sérialisation, afin de lui déléguer le processus de sérialisation ou de désérialisation.Assists formatters in selection of the serialization surrogate to delegate the serialization or deserialization process to.

XmlObjectSerializer

Fournit la classe de base utilisée pour sérialiser des objets en tant que documents ou flux XML.Provides the base class used to serialize objects as XML streams or documents. Cette classe est abstraite.This class is abstract.

XmlSerializableServices

Contient des méthodes pour lire et écrire du XML.Contains methods for reading and writing XML.

XPathQueryGenerator

Lorsqu'une classe représentant un contrat de données et les métadonnées représentant un membre du contrat sont fournies, produit une requête XPath pour le membre.When given a class representing a data contract, and metadata representing a member of the contract, produces an XPath query for the member.

XsdDataContractExporter

Autorise la transformation d’un ensemble de types .NET Framework qui sont utilisés dans les contrats de données en un fichier de schéma XML (.xsd).Allows the transformation of a set of .NET Framework types that are used in data contracts into an XML schema file (.xsd).

XsdDataContractImporter

Permet la transformation d'un ensemble de fichiers de schéma XML (.xsd) dans des types CLR (Common Language Runtime).Allows the transformation of a set of XML schema files (.xsd) into common language runtime (CLR) types.

Structures

SerializationEntry

Contient la valeur, Type, et le nom d'un objet sérialisé.Holds the value, Type, and name of a serialized object.

StreamingContext

Décrit la source et la destination d'un flux sérialisé donné et fournit un contexte supplémentaire défini par l'appelant.Describes the source and destination of a given serialized stream, and provides an additional caller-defined context.

Interfaces

IDataContractSurrogate

Fournit les méthodes nécessaires pour substituer un type à un autre par le DataContractSerializer pendant la sérialisation, la désérialisation, l'exportation et l'importation de documents de schéma XML (XSD).Provides the methods needed to substitute one type for another by the DataContractSerializer during serialization, deserialization, and export and import of XML schema documents (XSD).

IDeserializationCallback

Indique qu'une classe doit être notifiée lorsque la désérialisation du graphique d'objets est terminée.Indicates that a class is to be notified when deserialization of the entire object graph has been completed. Notez que cette interface n'est pas appelée en désérialisant avec XmlSerializer (System.Xml.Serialization.XmlSerializer).Note that this interface is not called when deserializing with the XmlSerializer (System.Xml.Serialization.XmlSerializer).

IExtensibleDataObject

Fournit une structure de données pour stocker des données supplémentaires rencontrées par le XmlObjectSerializer lors de la désérialisation d'un type marquée avec l'attribut DataContractAttribute.Provides a data structure to store extra data encountered by the XmlObjectSerializer during deserialization of a type marked with the DataContractAttribute attribute.

IFormatter

Fournit la fonctionnalité pour formater des objets sérialisés.Provides functionality for formatting serialized objects.

IFormatterConverter

Fournit la connexion entre une instance de SerializationInfo et la classe fournie par le formateur la plus adaptée pour analyser les données de SerializationInfo.Provides the connection between an instance of SerializationInfo and the formatter-provided class best suited to parse the data inside the SerializationInfo.

IObjectReference

Indique que l'implémenteur d'interface en cours est une référence à un autre objet.Indicates that the current interface implementer is a reference to another object.

ISafeSerializationData

Permet la sérialisation des données d'exception personnalisées dans du code transparent de sécurité.Enables serialization of custom exception data in security-transparent code.

ISerializable

Permet à un objet de contrôler ses propres sérialisation et désérialisation.Allows an object to control its own serialization and deserialization.

ISerializationSurrogate

Implémente un sélecteur de substitut de sérialisation qui permet à un objet d'effectuer la sérialisation et la désérialisation d'un autre.Implements a serialization surrogate selector that allows one object to perform serialization and deserialization of another.

ISerializationSurrogateProvider

Fournit les méthodes nécessaires pour construire un substitut de sérialisation qui étend DataContractSerializer.Provides the methods needed to construct a serialization surrogate that extends the DataContractSerializer. Un substitut de sérialisation est utilisé pendant la sérialisation et la désérialisation pour substituer un type à un autre.A serialization surrogate is used during serialization and deserialization to substitute one type for another.

ISurrogateSelector

Indique une classe de sélecteur de substitut de sérialisationIndicates a serialization surrogate selector class.

Énumérations

EmitTypeInformation

Spécifie la fréquence d'émission des informations de type.Specifies how often to emit type information.

StreamingContextStates

Définit un jeu d’indicateurs qui spécifie le contexte source ou de destination pour le flux pendant la sérialisation.Defines a set of flags that specifies the source or destination context for the stream during serialization.

Remarques

L'interface ISerializable permet aux classes de contrôler leur propre comportement de sérialisation.The ISerializable interface provides a way for classes to control their own serialization behavior. Classes dans le System.Runtime.Serialization.Formatters espace de noms contrôlent le formatage réel des différents types de données encapsulées dans les objets sérialisés.Classes in the System.Runtime.Serialization.Formatters namespace control the actual formatting of various data types encapsulated in the serialized objects.

Vous trouverez les formateurs qui sérialisent et désérialisent les objets vers et depuis un format particulier dans le System.Runtime.Serialization.Formatters espace de noms.Formatters that serialize and deserialize objects to and from a particular format can be found in the System.Runtime.Serialization.Formatters namespace.