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 sur l’application de ces attributs à une méthode de services web XML, consultez Sérialisation XML avec les services Web XML.
Pour plus d’informations sur les attributs, consultez Attributs.
Attribut | S’applique à | 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 est rempli avec les 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 avec les 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 sont 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. | Types dérivés qui peuvent être insérés dans un tableau. S'applique habituellement avec XmlArrayAttribute. |
XmlAttributeAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le membre est sérialisé en tant qu'attribut XML. |
XmlChoiceIdentifierAttribute | Champ public, propriété, paramètre ou valeur de retour. | L'ambiguïté du membre peut être levée à l'aide d'une énumération. |
XmlElementAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le champ ou la propriété est sérialisé en tant qu'élément XML. |
XmlEnumAttribute | Champ public qui est un identificateur d'énumération. | Nom d'élément d'un membre d'é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 publiques et valeurs de retour de méthodes publiques pour les documents WSDL (Web Services Description Language). | La classe doit être incluse lors de la génération de schémas (afin d'être reconnue en cas de sérialisation). |
XmlRootAttribute | Déclarations de classe publiques. | Contrôle la sérialisation XML de l'attribut cible en tant qu'élément racine XML. Utilisez l'attribut pour préciser l'espace de noms et le nom d'élément. |
XmlTextAttribute | Champs et propriétés publics. | La propriété ou le champ doit être sérialisé en tant que texte XML. |
XmlTypeAttribute | Déclarations de classe publiques. | Nom et espace de noms du type XML. |
ObsoleteAttribute | Champs et propriétés publics. | La propriété ou le champ va être ignoré lorsque la classe conteneur est sérialisée. |
En plus de ces attributs, qui se trouvent tous dans l'espace de noms System.Xml.Serialization, vous pouvez également appliquer l'attribut DefaultValueAttribute à un champ. DefaultValueAttribute définit la valeur qui sera assignée automatiquement au membre si aucune valeur n’est spécifiée.
Pour contrôler la sérialisation XML encodée selon le protocole SOAP, consultez Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP.