System.Xml.Serialization Espace de noms

L'espace de noms System.Xml.Serialization contient des classes servant à sérialiser des objets en documents au format XML ou en flux. The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

Classes

CodeExporter

Représente une classe qui peut générer le code proxy d'une représentation XML d'une structure de données.Represents a class that can generate proxy code from an XML representation of a data structure.

CodeIdentifier

Fournit des méthodes statiques pour convertir le texte d'entrée en noms pour les entités de code.Provides static methods to convert input text into names for code entities.

CodeIdentifiers

Gère un groupe de noms pour les entités de code connexes ou mappages de type qui sont générés par l'infrastructure de sérialisation XML du .NET Framework.Maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.

ImportContext

Décrit le contexte dans lequel un jeu de schéma est lié aux entités de code .NET Framework.Describes the context in which a set of schema is bound to .NET Framework code entities.

SchemaImporter

Décrit un importateur de schéma.Describes a schema importer.

SoapAttributeAttribute

Spécifie que XmlSerializer doit sérialiser le membre de la classe comme un attribut encodé par SOAP.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.

SoapAttributeOverrides

Permet de substituer des attributs appliqués à des propriétés, des champs et des classes lorsque vous utilisez XmlSerializer pour sérialiser ou désérialiser un objet encodé par SOAP.Allows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP.

SoapAttributes

Représente une collection d'objets attributs qui contrôlent la manière dont XmlSerializer sérialise et désérialise les méthodes SOAP.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.

SoapCodeExporter

Génère des types et des déclarations d'attribut à partir d'informations de mappage de type interne pour les parties de message encodées selon le protocole SOAP définies dans un document WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.

SoapElementAttribute

Spécifie que la valeur du membre public doit être sérialisée par XmlSerializer comme un élément XML SOAP encodé.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.

SoapEnumAttribute

Contrôle la manière dont XmlSerializer sérialise un membre de l'énumération.Controls how the XmlSerializer serializes an enumeration member.

SoapIgnoreAttribute

Commande à XmlSerializer de ne pas sérialiser la valeur du champ public ou de la propriété en lecture/écriture publique.Instructs the XmlSerializer not to serialize the public field or public read/write property value.

SoapIncludeAttribute

Permet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet comme du XML SOAP encodé.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

SoapReflectionImporter

Génère des mappages aux messages encodés selon le protocole SOAP d'informations de types .NET Framework ou de méthodes de service Web.Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.

SoapSchemaExporter

Remplit des objets XmlSchema avec les définitions de types de données de schéma XML pour les types .NET Framework qui sont sérialisés à l'aide de l'encodage SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.

SoapSchemaImporter

Utilisé dans le .NET Framework pour générer des mappages internes aux types .NET Framework pour les parties de message encodées selon le protocole SOAP dans un document WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.

SoapSchemaMember

Représente certains attributs d’un élément XSD <part> dans un document WSDL pour la génération de classes à partir du document.Represents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.

SoapTypeAttribute

Contrôle le schéma généré par XmlSerializer lorsqu'une instance de classe est sérialisée comme du XML SOAP encodé.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.

UnreferencedObjectEventArgs

Fournit des données pour l'objet connu, mais non référencé, trouvé dans un flux encodé XML SOAP lors de la désérialisation.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.

XmlAnyAttributeAttribute

Spécifie que le membre (un champ retournant un tableau d'objets XmlAttribute) peut contenir n'importe quel attribut XML.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.

XmlAnyElementAttribute

Spécifie que le membre (un champ retournant un tableau d'objets XmlElement ou XmlNode) contient des objets représentant tout élément XML n'ayant pas de membre correspondant dans l'objet en cours de sérialisation ou de désérialisation.Specifies that the member (a field that returns an array of XmlElement or XmlNode objects) contains objects that represent any XML element that has no corresponding member in the object being serialized or deserialized.

XmlAnyElementAttributes

Représente une collection d'objets XmlAnyElementAttribute.Represents a collection of XmlAnyElementAttribute objects.

XmlArrayAttribute

Spécifie que XmlSerializer doit sérialiser un membre de classe particulier en tant que tableau d'éléments XML.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements.

XmlArrayItemAttribute

Représente un attribut qui spécifie les types dérivés que le XmlSerializer peut placer dans un tableau sérialisé.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array.

XmlArrayItemAttributes

Représente une collection d'objets XmlArrayItemAttribute.Represents a collection of XmlArrayItemAttribute objects.

XmlAttributeAttribute

Spécifie que XmlSerializer doit sérialiser le membre de classe comme un attribut XML.Specifies that the XmlSerializer must serialize the class member as an XML attribute.

XmlAttributeEventArgs

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

XmlAttributeOverrides

Permet de substituer des attributs de propriété, de champ et de classe lorsque vous utilisez XmlSerializer pour sérialiser ou désérialiser un objet.Allows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.

XmlAttributes

Représente une collection d'objets attributs qui contrôlent la manière dont XmlSerializer sérialise et désérialise un objet.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.

XmlChoiceIdentifierAttribute

Spécifie que le membre peut être détecté à l'aide d'une énumération.Specifies that the member can be further detected by using an enumeration.

XmlCodeExporter

Génère des types et des déclarations d'attribut à partir d'informations de mappage de type interne pour les déclarations d'élément de schéma XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations.

XmlElementAttribute

Indique qu'un champ public ou une propriété publique représente un élément XML lorsque XmlSerializer sérialise ou désérialise l'objet qui le contient.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.

XmlElementAttributes

Représente une collection d’objets XmlElementAttribute utilisée par XmlSerializer pour substituer la sérialisation par défaut d’une classe.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.

XmlElementEventArgs

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

XmlEnumAttribute

Contrôle la manière dont XmlSerializer sérialise un membre de l'énumération.Controls how the XmlSerializer serializes an enumeration member.

XmlIgnoreAttribute

Commande à la méthode Serialize(TextWriter, Object) de XmlSerializer de ne pas sérialiser la valeur du champ public ou de la propriété en lecture/écriture publique.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value.

XmlIncludeAttribute

Permet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object.

XmlMapping

Prend en charge les mappages entre les types .NET Framework et les types de données de schéma XML.Supports mappings between .NET Framework types and XML Schema data types.

XmlMemberMapping

Mappe une entité de code dans une méthode de service Web .NET Framework à un élément dans un message WSDL (Web Services Description Language).Maps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.

XmlMembersMapping

Fournit des mappages entre les méthodes de service Web .NET Framework et les messages WSDL qui sont définis pour les services Web SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlNamespaceDeclarationsAttribute

Spécifie que le paramètre, la valeur de retour, le membre de classe ou la propriété cible contient des préfixes associés aux espaces de noms utilisés dans un document XML.Specifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document.

XmlNodeEventArgs

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

XmlReflectionImporter

Génère des mappages aux déclarations d'élément de schéma XML, y compris des parties de messages XSD littérales dans un document WSDL, pour les types .NET Framework ou les informations de méthode de service Web.Generates mappings to XML schema element declarations, including literal XML Schema Definition (XSD) message parts in a Web Services Description Language (WSDL) document, for .NET Framework types or Web service method information.

XmlReflectionMember

Fournit des mappages entre les entités de code des méthodes de service Web .NET Framework et le contenu des messages WSDL qui sont définis pour les services Web SOAP.Provides mappings between code entities in .NET Framework Web service methods and the content of Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlRootAttribute

Contrôle la sérialisation XML de la cible d'attribut en tant qu'élément racine XML.Controls XML serialization of the attribute target as an XML root element.

XmlSchemaEnumerator

Permet d’effectuer une itération au sein d’une collection d’objets XmlSchema.Enables iteration over a collection of XmlSchema objects.

XmlSchemaExporter

Remplit des objets XmlSchema avec les déclarations d'élément de schéma XML qui se trouvent dans les objets de mappage de type.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects.

XmlSchemaImporter

Génère des mappages internes aux types .NET Framework pour les déclarations d'élément de schéma XML, y compris des parties de messages XSD littérales dans un document WSDL.Generates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.

XmlSchemaProviderAttribute

Quand il est appliqué à un type, stocke le nom d’une méthode statique du type qui retourne un schéma XML et un XmlQualifiedName (ou XmlSchemaType pour les types anonymes) qui contrôle la sérialisation du type.When applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName (or XmlSchemaType for anonymous types) that controls the serialization of the type.

XmlSchemas

Représente la collection de schémas XL.Represents the collection of XML schemas.

XmlSerializationGeneratedCode

Classe abstraite qui est la classe de base pour XmlSerializationReader et XmlSerializationWriter et contient des méthodes communes aux deux types.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.

XmlSerializationReader

Contrôle la désérialisation par la classe XmlSerializer.Controls deserialization by the XmlSerializer class.

XmlSerializationReader.CollectionFixup

Contient une instance de délégué XmlSerializationCollectionFixupCallback, plus les entrées de la méthode ; fournit également les paramètres de la méthode.Holds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.

XmlSerializationReader.Fixup

Stocke une instance de délégué XmlSerializationFixupCallback, ainsi que les entrées de la méthode ; est également utilisé comme paramètre pour la méthode.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.

XmlSerializationWriter

Représente une classe abstraite utilisée pour le contrôle de la sérialisation par la classe XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class.

XmlSerializer

Sérialise et désérialise des objets vers et depuis des documents XML.Serializes and deserializes objects into and from XML documents. XmlSerializer permet de contrôler le mode d'encodage des objets en langage XML.The XmlSerializer enables you to control how objects are encoded into XML.

XmlSerializerAssemblyAttribute

Appliqué à un proxy client de service Web, vous permet de spécifier un assembly qui contient des sérialiseurs personnalisés.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.

XmlSerializerFactory

Crée des versions typées de XmlSerializer pour une sérialisation plus efficace.Creates typed versions of the XmlSerializer for more efficient serialization.

XmlSerializerImplementation

Définit le lecteur, le writer et les méthodes pour les sérialiseurs typés déjà générés.Defines the reader, writer, and methods for pre-generated, typed serializers.

XmlSerializerNamespaces

Contient les espaces de noms et préfixes XML utilisés par XmlSerializer pour générer des noms qualifiés dans une instance de document XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

XmlSerializerVersionAttribute

Signifie que le code a été généré par l'infrastructure de sérialisation et peut être réutilisé pour de meilleures performances, lorsque cet attribut est appliqué à un assembly.Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly.

XmlTextAttribute

Indique à XmlSerializer que le membre doit être traité comme du texte XML lorsque la classe qui le contient est sérialisée ou désérialisée.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.

XmlTypeAttribute

Contrôle le schéma XML qui est généré lorsque la cible de l'attribut est sérialisée par XmlSerializer.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

XmlTypeMapping

Contient un mappage d'un type à l'autre.Contains a mapping of one type to another.

Structures

XmlDeserializationEvents

Contient des champs qui peuvent être utilisés pour passer des délégués d'événement à une méthode Deserialize thread-safe de XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

Interfaces

IXmlSerializable

Fournit une mise en forme personnalisée pour la désérialisation et la sérialisation XML.Provides custom formatting for XML serialization and deserialization.

IXmlTextParser

Crée une propriété Normalized qui est utilisée par l'infrastructure .NET Framework.Establishes a Normalized property for use by the .NET Framework infrastructure.

Énumérations

CodeGenerationOptions

Spécifie différentes options à utiliser lors de la génération de types .NET pour une utilisation avec un service web XML.Specifies various options to use when generating .NET types for use with an XML Web Service.

XmlMappingAccess

Spécifie si un mappage est accessible en lecture, en écriture, ou les deux.Specifies whether a mapping is read, write, or both.

Délégués

UnreferencedObjectEventHandler

Représente la méthode qui gère l'événement UnreferencedObject de XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer.

XmlAttributeEventHandler

Représente la méthode qui gère UnknownAttribute.Represents the method that handles the UnknownAttribute

XmlElementEventHandler

Représente la méthode qui gère l'événement UnknownElement de XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer.

XmlNodeEventHandler

Représente la méthode qui gère l'événement UnknownNode de XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer.

XmlSerializationCollectionFixupCallback

Délégué utilisé par la classe XmlSerializer pour la désérialisation des types de données XML encodées selon le protocole SOAP qui correspondent aux collections ou énumérations.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.

XmlSerializationFixupCallback

Délégué utilisé par la classe XmlSerializer pour la désérialisation de données XML encodées selon le protocole SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.

XmlSerializationReadCallback

Délégué utilisé par la classe XmlSerializer pour la désérialisation de types de données encodées selon le protocole SOAP ou de données XML qui ne sont pas situées à la racine.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.

XmlSerializationWriteCallback

Délégué utilisé par la classe XmlSerializer pour la sérialisation de types de données encodées selon le protocole SOAP ou de données XML qui ne sont pas situées à la racine.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

Remarques

La classe centrale de l’espace de noms est la XmlSerializer classe.The central class in the namespace is the XmlSerializer class. Pour utiliser cette classe, utilisez le XmlSerializer constructeur pour créer une instance de la classe en utilisant le type de l’objet à sérialiser.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Une fois un XmlSerializer est créé, créez une instance de l’objet à sérialiser.Once an XmlSerializer is created, create an instance of the object to serialize. Vous devez également créer un objet pour écrire le fichier dans un document ou le flux, par exemple un Stream, TextWriter, ou XmlWriter.You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. Vous pouvez ensuite appeler la Serialize méthode pour convertir l’objet en un document XML.You can then call the Serialize method to convert the object into an XML document.

Pour désérialiser un objet à partir d’un document XML, créez un objet pour lire le document ou le flux (là encore, un Stream, TextWriter, ou XmlWriter).To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Appeler le Deserialize méthode lors de la conversion de l’objet résultant pour le type de l’objet d’origine (qui a été sérialisé).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

Pour mieux contrôler la sérialisation, le System.Xml.Serialization espace de noms contient plusieurs Attribute classes qui peuvent être appliqués aux membres d’une classe.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Par exemple, si une classe contient un membre qui sera sérialisé comme un élément XML, vous pouvez appliquer la XmlElementAttribute au membre d’attribut.For example, if a class contains a member that will be serialized as an XML element, you can apply the XmlElementAttribute attribute to the member. Lorsque vous appliquez l’attribut, vous pouvez spécifier des détails tels que le véritable XML élément nom en utilisant le ElementName propriété.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Pour obtenir une liste complète de tous les attributs, consultez le XmlSerializer vue d’ensemble de la classe.For a complete list of all the attributes, see the XmlSerializer class overview.