Exporter (0) Imprimer
Développer tout
Développer Réduire

System.Xml.Serialization, espace de noms

Mise à jour : novembre 2007

L'espace de noms System.Xml.Serialization contient des classes servant à sérialiser des objets en documents au format XML ou en flux.

La classe centrale de l'espace de noms est la classe XmlSerializer. Pour utiliser cette classe, servez-vous du constructeur XmlSerializer pour créer une instance de la classe à l'aide du type de l'objet à sérialiser. Dès qu'un XmlSerializer est créé, créez une instance de l'objet à sérialiser. Vous devez aussi créer un objet pour écrire le fichier dans un document ou un flux, tel que Stream, TextWriter, ou XmlWriter. Vous pouvez ensuite appeler la méthode Serialize() pour convertir l'objet en un document XML.

Pour désérialiser un objet à partir d'un document XML, créez un objet permettant la lecture du document ou du flux (ici encore, Stream, TextWriter, ou XmlWriter). Appelez la méthode Deserialize() lorsque vous effectuez un cast sur l'objet résultant dans le type de l'objet d'origine (sérialisé).

Pour mieux contrôler la sérialisation, l'espace de noms System.Xml.Serialization contient plusieurs classes Attribute qui peuvent s'appliquer aux membres d'une classe. Par exemple, si une classe contient un membre à sérialiser comme un é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 l'élément XML actuel au moyen de la propriété ElementName. Pour obtenir une liste complète d'attributs, consultez la vue d'ensemble de la classe XmlSerializer.

  ClasseDescription
CodeExporterReprésente une classe qui peut générer le code proxy d'une représentation XML d'une structure de données.
CodeIdentifierInfrastructure. Fournit des méthodes statiques pour convertir le texte d'entrée en noms pour les entités de code.
CodeIdentifiersInfrastructure. 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.
ImportContextInfrastructure. Décrit le contexte dans lequel un jeu de schéma est lié aux entités de code .NET Framework.
SchemaImporterDécrit un importateur de schéma.
SoapAttributeAttributeSpécifie que XmlSerializer doit sérialiser le membre de la classe comme un attribut codé par SOAP.
SoapAttributeOverridesPermet 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 codé par SOAP.
SoapAttributesReprésente une collection d'objets attributs qui contrôlent la manière dont XmlSerializer sérialise et désérialise les méthodes SOAP.
SoapCodeExporterInfrastructure. Génère des types et des déclarations d'attribut à partir d'informations de mappage de type interne pour les parties de message codées selon le protocole SOAP définies dans un document WSDL.
SoapElementAttributeSpécifie que la valeur du membre public doit être sérialisée par XmlSerializer comme un élément XML SOAP codé.
SoapEnumAttributeContrôle la manière dont XmlSerializer sérialise un membre d'énumération.
SoapIgnoreAttributeCommande à XmlSerializer de ne pas sérialiser la valeur du champ public ou de la propriété en lecture/écriture publique.
SoapIncludeAttributePermet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet comme du XML SOAP codé.
SoapReflectionImporterGénère des mappages aux messages codés selon le protocole SOAP d'informations de types .NET Framework ou de méthodes de service Web.
SoapSchemaExporterInfrastructure. 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 du codage SOAP.
SoapSchemaImporterInfrastructure. Utilisé dans le .NET Framework pour générer des mappages internes aux types .NET Framework pour les parties de message codées selon le protocole SOAP dans un document WSDL.
SoapSchemaMemberInfrastructure. Représente certains attributs d'un élément <part> XSD dans un document WSDL pour générer des classes à partir du document.
SoapTypeAttributeContrôle le schéma généré par XmlSerializer lorsqu'une instance de classe est sérialisée comme du XML SOAP codé.
UnreferencedObjectEventArgsFournit des données pour l'objet connu, mais non référencé, trouvé dans un flux codé XML SOAP lors de la désérialisation.
XmlAnyAttributeAttributeSpé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.
XmlArrayAttributeSpécifie que XmlSerializer doit sérialiser un membre de classe particulier en tant que tableau d'éléments XML.
XmlArrayItemAttribute Spécifie les types dérivés que 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.
XmlAttributeEventArgsFournit 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.
XmlAttributesReprésente une collection d'objets attributs qui contrôlent la manière dont XmlSerializer sérialise et désérialise un objet.
XmlChoiceIdentifierAttributeSpécifie qu'il est possible d'utiliser une énumération pour détecter le membre.
XmlCodeExporterInfrastructure. 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.
XmlElementAttributeIndique 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.
XmlElementAttributesReprésente une collection d'objets XmlElementAttribute utilisée par XmlSerializer pour substituer la sérialisation par défaut d'une classe.
XmlElementEventArgsFournit des données pour l'événement UnknownElement.
XmlEnumAttributeContrôle la manière dont XmlSerializer sérialise un membre de l'énumération.
XmlIgnoreAttributeCommande à la méthode Serialize de XmlSerializer de ne pas sérialiser la valeur du champ public ou de la propriété en lecture/écriture publique.
XmlIncludeAttributePermet à XmlSerializer de reconnaître un type lorsqu'il sérialise ou désérialise un objet.
XmlMappingInfrastructure. Prend en charge les mappages entre les types .NET Framework et les types de données de schéma XML.
XmlMemberMappingInfrastructure. 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).
XmlMembersMappingInfrastructure. 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.
XmlNamespaceDeclarationsAttributeSpécifie que la propriété, le paramètre, la valeur de retour ou le membre de classe cible contient des préfixes associés aux espaces de noms utilisés dans un document XML.
XmlNodeEventArgsFournit des données pour l'événement UnknownNode.
XmlReflectionImporterInfrastructure. 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.
XmlReflectionMemberInfrastructure. 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.
XmlRootAttribute Contrôle la sérialisation XML de l'attribut cible en tant qu'élément racine XML.
XmlSchemaEnumerator Permet le parcours d'une collection d'objets XmlSchema.
XmlSchemaExporterInfrastructure. 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.
XmlSchemaImporterInfrastructure. 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.
XmlSchemaProviderAttributeDans le cadre d'une application à 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.
XmlSchemasInfrastructure. Représente la collection de schémas XML.
XmlSerializationGeneratedCodeInfrastructure. Classe abstraite qui est la classe de base pour XmlSerializationReader et XmlSerializationWriter et contient des méthodes communes aux deux types.
XmlSerializationReaderInfrastructure. Contrôle la désérialisation par la classe XmlSerializer.
XmlSerializationReader.CollectionFixupContient 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.FixupInfrastructure. 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.
XmlSerializationWriterInfrastructure. Classe abstraite utilisée pour le contrôle de la sérialisation par la classe XmlSerializer.
XmlSerializerSérialise et désérialise des objets dans des documents XML ou à partir de documents XML. XmlSerializer permet de contrôler le mode de codage des objets en langage XML.
XmlSerializerAssemblyAttributeAppliqué à un proxy client de service Web, vous permet de spécifier un assembly qui contient des sérialiseurs personnalisés.
XmlSerializerFactoryInfrastructure. Crée des versions typées de XmlSerializer pour une sérialisation plus efficace.
XmlSerializerImplementationInfrastructure. Définit le lecteur, le writer et les méthodes pour les sérialiseurs typés déjà générés.
XmlSerializerNamespacesContient 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.
XmlSerializerVersionAttributeSignifie 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.
XmlTextAttributeIndique à 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.
XmlTypeAttributeContrô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.

  StructureDescription
XmlDeserializationEventsContient 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.

  InterfaceDescription
IXmlSerializableOffre une mise en forme personnalisée pour la sérialisation et la désérialisation XML.
IXmlTextParserInfrastructure. Crée une propriété Normalized qui est utilisée par l'infrastructure .NET Framework.

  DéléguéDescription
UnreferencedObjectEventHandlerReprésente la méthode qui gère l'événement UnreferencedObject de XmlSerializer.
XmlAttributeEventHandlerReprésente la méthode qui gère UnknownAttribute.
XmlElementEventHandlerReprésente la méthode qui gère l'événement UnknownElement de XmlSerializer.
XmlNodeEventHandlerReprésente la méthode qui gère l'événement UnknownNode de XmlSerializer.
XmlSerializationCollectionFixupCallbackInfrastructure. Délégué utilisé par la classe XmlSerializer pour la désérialisation des types de données XML codées selon le protocole SOAP qui correspondent aux collections ou énumérations.
XmlSerializationFixupCallbackInfrastructure. Délégué utilisé par la classe XmlSerializer pour la désérialisation de données XML codées selon le protocole SOAP.
XmlSerializationReadCallbackInfrastructure. Délégué utilisé par la classe XmlSerializer pour la désérialisation de types de données codées selon le protocole SOAP ou de données XML qui ne sont pas situées à la racine.
XmlSerializationWriteCallbackInfrastructure. Délégué utilisé par la classe XmlSerializer pour la sérialisation de types de données codées selon le protocole SOAP ou de données XML qui ne sont pas situées à la racine.

  ÉnumérationDescription
CodeGenerationOptionsSpécifie différentes options à utiliser lors de la génération de types .NET Framework pour une utilisation avec un service Web XML.
XmlMappingAccessInfrastructure. Spécifie si un mappage est accessible en lecture, en écriture, ou les deux.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft