Attributs qui contrôlent la sérialisation XML
Vous pouvez appliquer les attributs du tableau suivant à des classes et à des membres de classe pour contrôler la manière dont XmlSerializer sérialise ou désérialise une instance de la classe. Pour comprendre comment ces attributs contrôlent la sérialisation XML, consultez Contrôle de la sérialisation XML à l'aide d'attributs.
Ces attributs peuvent également être utilisés pour contrôler les messages SOAP de style littéral générés par un service Web XML. Pour plus d'informations relatives à l'application de ces attributs à une méthode de services Web XML, consultez Sérialisation XML à l'aide des services Web XML.
Pour plus d'informations sur les attributs, consultez Extension des métadonnées à l'aide des attributs.
| Attribut | Application à | Spécifie |
|---|---|---|
| XmlAnyAttributeAttribute | Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets XmlAttribute. | Lors de la désérialisation, le tableau sera rempli d'objets XmlAttribute qui représentent tous les attributs XML inconnus du schéma. |
| XmlAnyElementAttribute | Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets XmlElement. | Lors de la désérialisation, le tableau est rempli d'objets XmlElement qui représentent tous les éléments XML inconnus du schéma. |
| XmlArrayAttribute | Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets complexes. | Les membres du tableau seront générés en tant que membres d'un tableau XML. |
| XmlArrayItemAttribute | Champ public, propriété, paramètre, ou valeur de retour qui retourne un tableau d'objets complexes. | Les types dérivés qui peuvent être insérés dans un tableau. S'appliquent habituellement en association avec XmlArrayAttribute. |
| XmlAttributeAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le membre sera sérialisé en tant qu'attribut XML. |
| XmlChoiceIdentifierAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le membre peut être davantage désambiguïsé à l'aide d'une énumération. |
| XmlElementAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le champ ou la propriété sera sérialisée en tant qu'élément XML. |
| XmlEnumAttribute | Champ public qui est un identificateur d'énumération. | Le nom d'élément d'un membre d'une énumération. |
| XmlIgnoreAttribute | Champs et propriétés publics | La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée. |
| XmlIncludeAttribute | Déclarations de classe dérivée publique, et valeurs de retour de méthodes publiques (pour des documents WSDL (Web Service Description Language)). | La classe doit être incluse lors de la génération de schémas (à reconnaître lors de leur sérialisation). |
| XmlRootAttribute | Déclarations de classe publique. | Contrôle la sérialisation XML de la cible de l'attribut comme un élément racine XML. Utilisez l'attribut pour spécifier davantage l'espace de noms et le nom d'élément. |
| XmlTextAttribute | Champs et propriétés publics | Le champ ou la propriété doit être sérialisée en tant que texte XML. |
| XmlTypeAttribute | Déclarations de classe publique. | Le nom et l'espace de noms du type XML. |
En plus de ces attributs qui figurent tous dans l'espace de noms System.Xml.Serialization, vous pouvez également appliquer l'attribut System.ComponentModel.DefaultValueAttribute à un champ. DefaultValueAttribute définit la valeur qui sera automatiquement assignée au membre si aucune valeur n'est spécifiée.
Pour contrôler la sérialisation XML codée en SOAP, consultez Attributs qui contrôlent la sérialisation codée en SOAP.
Voir aussi
Sérialisation XML et SOAP | XmlSerializer | Contrôle de la sérialisation XML à l'aide d'attributs | Substitution de la sérialisation XML