System.Xml.Serialization Espace de noms

Contient des classes utilisées pour sérialiser des objets dans des documents ou des flux au format XML.

Classes

Nom	Description
CodeIdentifier	Fournit des méthodes statiques pour convertir du 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 associées ou les mappages de types générés par . Infrastructure de sérialisation XML de NET.
ImportContext	Décrit le contexte dans lequel un ensemble de schémas est lié aux entités de code .NET.
SchemaImporter	Décrit un importateur de schéma.
SoapAttributeAttribute	Spécifie que le XmlSerializer doit sérialiser le membre de classe en tant qu’attribut SOAP encodé.
SoapAttributeOverrides	Vous permet de remplacer les attributs appliqués aux propriétés, aux champs et aux classes lorsque vous utilisez un XmlSerializer objet pour sérialiser ou désérialiser un objet en tant que SOAP encodé.
SoapAttributes	Représente une collection d’objets d’attribut qui contrôlent la façon dont les XmlSerializer méthodes SOAP sérialisent et désérialisent.
SoapElementAttribute	Spécifie que la valeur de membre public doit être sérialisée par l'XmlSerializer en tant qu’élément XML SOAP encodé.
SoapEnumAttribute	Contrôle la façon dont le XmlSerializer sérialise un membre d’énumération.
SoapIgnoreAttribute	Indique au XmlSerializer de ne pas sérialiser le champ public ou la valeur de propriété en lecture/écriture publique.
SoapIncludeAttribute	Permet au XmlSerializer de reconnaître un type lorsqu’il sérialise ou désérialise un objet en tant que code SOAP XML encodé.
SoapReflectionImporter	Génère des mappages aux messages encodés par SOAP à partir de types .NET ou d’informations de méthode de service Web.
SoapSchemaMember	Représente certains attributs d’un élément XSD <part> dans un document WSDL pour générer des classes à partir du document.
SoapTypeAttribute	Contrôle le schéma généré par l'XmlSerializer lorsqu’une instance de classe est sérialisée en tant que code XML encodé SOAP.
UnreferencedObjectEventArgs	Fournit des données pour l’objet connu, mais non référencé, trouvé dans un flux XML SOAP encodé lors de la désérialisation.
XmlAnyAttributeAttribute	Spécifie que le membre (champ qui retourne un tableau d’objets XmlAttribute) peut contenir n’importe quel attribut XML.
XmlAnyElementAttribute	Spécifie que le membre (champ qui retourne un tableau d’objets XmlElement ou XmlNode) contient des objets qui représentent tout élément XML qui n’a aucun membre correspondant dans l’objet sérialisé ou désérialisé.
XmlAnyElementAttributes	Représente une collection d’objets XmlAnyElementAttribute .
XmlArrayAttribute	Spécifie que le 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 le XmlSerializer doit sérialiser le membre de classe en tant qu’attribut XML.
XmlAttributeEventArgs	Fournit des données pour l'événement UnknownAttribute.
XmlAttributeOverrides	Vous permet de remplacer les attributs de propriété, de champ et de classe lorsque vous utilisez la XmlSerializer propriété pour sérialiser ou désérialiser un objet.
XmlAttributes	Représente une collection d’objets d’attribut qui contrôlent la façon dont le XmlSerializer sérialise et désérialise un objet.
XmlChoiceIdentifierAttribute	Spécifie que le membre peut être détecté davantage à l’aide d’une énumération.
XmlElementAttribute	Indique qu’un champ public ou une propriété représente un élément XML lorsque l'XmlSerializer sérialise ou désérialise l’objet qui le contient.
XmlElementAttributes	Représente une collection d’objets XmlElementAttribute utilisés par la XmlSerializer méthode par défaut pour sérialiser une classe.
XmlElementEventArgs	Fournit des données pour l'événement UnknownElement.
XmlEnumAttribute	Contrôle la façon dont le XmlSerializer sérialise un membre d’énumération.
XmlIgnoreAttribute	Indique à la méthode Serialize(TextWriter, Object) de l'XmlSerializer de ne pas sérialiser le champ public ou la valeur de propriété en lecture/écriture publique.
XmlIncludeAttribute	Permet au 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 de schéma XML.
XmlMemberMapping	Mappe une entité de code dans une méthode de service web .NET à un élément dans un message WSDL (Web Services Description Language).
XmlMembersMapping	Fournit 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 la propriété cible, le paramètre, la valeur de retour ou le membre de classe 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 aux déclarations d’éléments de schéma XML, y compris les composants de message XSD (Littéral XML Schema Definition) dans un document WSDL (Web Services Description Language), pour les informations sur les types .NET ou les méthodes de service Web.
XmlReflectionMember	Fournit des mappages entre les entités de code dans les 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 la cible d’attribut en tant qu’élément racine XML.
XmlSchemaEnumerator	Active l’itération sur une collection d’objets XmlSchema .
XmlSchemaExporter	Remplit des objets avec des XmlSchema déclarations d’éléments de schéma XML trouvées dans les objets de mappage de type.
XmlSchemaImporter	Génère des mappages internes aux types .NET pour les déclarations d’éléments de schéma XML, y compris les parties de message XSD littérales dans un document WSDL.
XmlSchemaProviderAttribute	Lorsqu’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 XML.
XmlSerializationGeneratedCode	Classe abstraite pour XmlSerializationReader et XmlSerializationWriter qui contient des méthodes communes à ces deux types.
XmlSerializationReader	Contrôle la désérialisation par la XmlSerializer classe.
XmlSerializationReader.CollectionFixup	Contient une XmlSerializationCollectionFixupCallback instance de délégué, ainsi que les entrées de la méthode ; fournit également les paramètres de la méthode.
XmlSerializationReader.Fixup	Contient une XmlSerializationFixupCallback instance de délégué, ainsi que les entrées de la méthode ; sert également de paramètre pour la méthode.
XmlSerializationWriter	Représente une classe abstraite utilisée pour contrôler la sérialisation par la XmlSerializer classe.
XmlSerializer	Sérialise et désérialise les objets dans et à partir de documents XML. Vous XmlSerializer pouvez contrôler la façon dont les objets sont encodés en 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 la XmlSerializer sérialisation plus efficace.
XmlSerializerImplementation	Définit le lecteur, l’enregistreur et les méthodes pour les sérialiseurs prégénés et typés.
XmlSerializerNamespaces	Contient les espaces de noms ET préfixes XML utilisés 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 améliorer les performances, lorsque cet attribut est appliqué à un assembly.
XmlTextAttribute	Indique à l'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 généré lorsque la cible d’attribut est sérialisée par le XmlSerializer.
XmlTypeMapping	Contient un mappage d’un type à un autre.

Structures

Nom	Description
XmlDeserializationEvents	Contient des champs qui peuvent être utilisés pour passer des délégués d’événements à une méthode de Deserialize thread-safe de l'XmlSerializer.

Interfaces

Nom	Description
IXmlSerializable	Fournit une mise en forme personnalisée pour la sérialisation ET la désérialisation XML.
IXmlTextParser	Établit une Normalized propriété à utiliser par l’infrastructure .NET.

Énumérations

Nom	Description
CodeGenerationOptions	Spécifie différentes options à utiliser lors de la génération de types .NET à utiliser avec un service web XML.
XmlMappingAccess	Spécifie si un mappage est lu, écrit ou les deux.

Délégués

Nom	Description
UnreferencedObjectEventHandler	Représente la méthode qui gère l’événement UnreferencedObject d’un XmlSerializer.
XmlAttributeEventHandler	Représente la méthode qui gère le UnknownAttribute.
XmlElementEventHandler	Représente la méthode qui gère l’événement UnknownElement d’un XmlSerializer.
XmlNodeEventHandler	Représente la méthode qui gère l’événement UnknownNode d’un XmlSerializer.
XmlSerializationCollectionFixupCallback	Délégué utilisé par la XmlSerializer classe pour la désérialisation des types de données XML encodés SOAP qui mappent à des collections ou des énumérations.
XmlSerializationFixupCallback	Délégué utilisé par la XmlSerializer classe pour la désérialisation des données XML encodées SOAP.
XmlSerializationReadCallback	Délégué utilisé par la XmlSerializer classe pour la désérialisation des types à partir de données XML non racines codées par SOAP.
XmlSerializationWriteCallback	Délégué utilisé par la classe pour la XmlSerializer sérialisation de types à partir de données XML non racines codées par SOAP.

Remarques

La classe centrale dans l’espace de noms est la XmlSerializer classe. Pour utiliser cette classe, utilisez le XmlSerializer constructeur pour créer une instance de la classe à l’aide du type de l’objet à sérialiser. Une fois l’objet XmlSerializer 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 (à nouveau, un Stream, TextWriterou XmlWriter). Appelez la Deserialize méthode lors du cast de l’objet résultant sur le type de l’objet d’origine (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. Lorsque vous appliquez l’attribut, vous pouvez spécifier des détails tels que le nom d’élément XML réel à 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.