System.Xml.Serialization Espace de noms

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

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.

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.

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.

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.

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.

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.

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.

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.

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.