System.Xml.Serialization Espace de noms

Contient des classes servant à sérialiser des objets en flux ou en documents au format XML.

Classes

CodeIdentifier	Fournit des méthodes statiques pour convertir le texte d'entrée en noms pour les entités de code.
CodeIdentifiers	Gère un groupe de noms pour les entités de code ou les mappages de type liés générés par l’infrastructure de sérialisation XML de .NET.
ImportContext	Décrit le contexte dans lequel un jeu de schéma est lié à des entités de code .NET.
SchemaImporter	Décrit un importateur de schéma.
SoapAttributeAttribute	Spécifie que XmlSerializer doit sérialiser le membre de la classe comme un attribut encodé par SOAP.
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.
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.
SoapElementAttribute	Spécifie que la valeur du membre public doit être sérialisée par XmlSerializer comme un élément XML SOAP encodé.
SoapEnumAttribute	Contrôle la manière dont XmlSerializer sérialise un membre de l'énumération.
SoapIgnoreAttribute	Commande à XmlSerializer de ne pas sérialiser la valeur du champ public ou de la propriété en lecture/écriture publique.
SoapIncludeAttribute	Permet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet comme du XML SOAP encodé.
SoapReflectionImporter	Génère des mappages avec des messages encodés selon le protocole SOAP à partir de types .NET ou d’informations sur les méthodes de service web.
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.
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é.
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.
XmlAnyAttributeAttribute	Spécifie que le membre (un champ retournant un tableau d'objets XmlAttribute) peut contenir n'importe quel attribut XML.
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.
XmlAnyElementAttributes	Représente une collection d'objets XmlAnyElementAttribute.
XmlArrayAttribute	Spécifie que XmlSerializer doit sérialiser un membre de classe particulier en tant que tableau d'éléments XML.
XmlArrayItemAttribute	Représente un attribut qui spécifie les types dérivés que le XmlSerializer peut placer dans un tableau sérialisé.
XmlArrayItemAttributes	Représente une collection d'objets XmlArrayItemAttribute.
XmlAttributeAttribute	Spécifie que XmlSerializer doit sérialiser le membre de classe comme un attribut XML.
XmlAttributeEventArgs	Fournit des données pour l'événement UnknownAttribute.
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.
XmlAttributes	Représente une collection d'objets attributs qui contrôlent la manière dont XmlSerializer sérialise et désérialise un objet.
XmlChoiceIdentifierAttribute	Spécifie que le membre peut être détecté à l'aide d'une énumération.
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.
XmlElementAttributes	Représente une collection d’objets XmlElementAttribute utilisée par XmlSerializer pour substituer la sérialisation par défaut d’une classe.
XmlElementEventArgs	Fournit des données pour l'événement UnknownElement.
XmlEnumAttribute	Contrôle la manière dont XmlSerializer sérialise un membre de l'énumération.
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.
XmlIncludeAttribute	Permet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet.
XmlMapping	Prend en charge les mappages entre les types .NET et les types de données XML Schema.
XmlMemberMapping	Mappe une entité de code d’une méthode de service web .NET avec un élément d’un message WSDL (Web Services Description Language).
XmlMembersMapping	Assure des mappages entre les méthodes de service web .NET et les messages WSDL (Web Services Description Language) définis pour les services web SOAP.
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.
XmlNodeEventArgs	Fournit des données pour l'événement UnknownNode.
XmlReflectionImporter	Génère des mappages avec des déclarations d’éléments XML Schema, y compris des parties de messages XSD (XML Schema Definition) littérales dans un document WSDL (Web Services Description Language), pour des types .NET ou des informations sur les méthodes de service web.
XmlReflectionMember	Assure des mappages entre les entités de code des méthodes de service web .NET et le contenu des messages WSDL (Web Services Description Language) définis pour les services web SOAP.
XmlRootAttribute	Contrôle la sérialisation XML de l'attribut cible en tant qu'élément racine XML.
XmlSchemaEnumerator	Permet d’effectuer une itération au sein d’une collection d’objets XmlSchema.
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.
XmlSchemaImporter	Génère des mappages internes avec des types .NET pour des déclarations d’éléments XML Schema, y compris des parties de messages XSD littérales dans un document WSDL.
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.
XmlSchemas	Représente la collection de schémas XL.
XmlSerializationGeneratedCode	Classe abstraite qui est la classe de base pour XmlSerializationReader et XmlSerializationWriter et contient des méthodes communes aux deux types.
XmlSerializationReader	Contrôle la désérialisation par la classe XmlSerializer.
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.
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.
XmlSerializationWriter	Représente une classe abstraite utilisée pour le contrôle de la sérialisation par la classe XmlSerializer.
XmlSerializer	Sérialise et désérialise des objets vers et depuis des documents XML. XmlSerializer permet de contrôler le mode d'encodage des objets en langage XML.
XmlSerializerAssemblyAttribute	Appliqué à un proxy client de service Web, vous permet de spécifier un assembly qui contient des sérialiseurs personnalisés.
XmlSerializerFactory	Crée des versions typées de XmlSerializer pour une sérialisation plus efficace.
XmlSerializerImplementation	Définit le lecteur, le writer et les méthodes pour les sérialiseurs typés déjà générés.
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.
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.
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.
XmlTypeAttribute	Contrôle le schéma XML qui est généré lorsque la cible de l'attribut est sérialisée par XmlSerializer.
XmlTypeMapping	Contient un mappage d'un type à l'autre.

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.

Interfaces

IXmlSerializable	Fournit une mise en forme personnalisée pour la désérialisation et la sérialisation XML.
IXmlTextParser	Établit une propriété Normalized utilisée par l’infrastructure .NET.

É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.
XmlMappingAccess	Spécifie si un mappage est accessible en lecture, en écriture, ou les deux.

Délégués

UnreferencedObjectEventHandler	Représente la méthode qui gère l'événement UnreferencedObject de XmlSerializer.
XmlAttributeEventHandler	Représente la méthode qui gère UnknownAttribute.
XmlElementEventHandler	Représente la méthode qui gère l'événement UnknownElement de XmlSerializer.
XmlNodeEventHandler	Représente la méthode qui gère l'événement UnknownNode de 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.
XmlSerializationFixupCallback	Délégué utilisé par la classe XmlSerializer pour la désérialisation de données XML encodées selon le protocole SOAP.
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.
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.

Remarques

La classe centrale dans l’espace de noms est la XmlSerializer classe . Pour utiliser cette classe, utilisez le XmlSerializer constructeur pour créer un instance de la classe à l’aide du type de l’objet à sérialiser. Une fois qu’un XmlSerializer est créé, créez une instance de l’objet à sérialiser. Vous devez également créer un objet pour écrire le fichier dans un document ou un flux, tel qu’un Stream, TextWriterou XmlWriter. Vous pouvez ensuite appeler la Serialize méthode pour convertir l’objet en document XML.

Pour désérialiser un objet à partir d’un document XML, créez un objet approprié pour lire le document ou le flux (là encore, un Stream, TextWriterou XmlWriter). Appelez la Deserialize méthode lors de la conversion de l’objet résultant au type de l’objet d’origine (qui a été sérialisé).

Pour contrôler davantage la sérialisation, l’espace System.Xml.Serialization de noms contient plusieurs Attribute classes qui peuvent être appliquées aux membres d’une classe. Par exemple, si une classe contient un membre qui sera sérialisé en tant qu’élément XML, vous pouvez appliquer l’attribut XmlElementAttribute au membre. Lors de l’application de l’attribut, vous pouvez spécifier des détails tels que le nom réel de l’élément XML à l’aide de la ElementName propriété . Pour obtenir la liste complète de tous les attributs, consultez la vue d’ensemble de la XmlSerializer classe.