Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP
Le document World Wide Web Consortium (www.W3C.org) intitulé Simple Object Access Protocol (SOAP) 1.1 contient une section facultative (section 5) décrivant le codage des paramètres SOAP. Pour se conformer à la section 5 de la spécification, vous devez utiliser un ensemble spécial d’attributs figurant dans l’espace de noms System.Xml.Serialization. Appliquez ces attributs en fonction des classes et membres de classes, puis utilisez XmlSerializer pour sérialiser les instances de la ou des classes.
Le tableau suivant affiche les attributs, leurs conditions d'application et l'action qu'ils entraînent. Pour plus d’informations sur l’utilisation de ces attributs pour contrôler la sérialisation XML, consultez Guide pratique pour sérialiser un objet en tant que flux XML encodé selon le protocole SOAP et Guide pratique pour remplacer la sérialisation XML encodée selon le protocole SOAP.
Pour plus d’informations sur les attributs, consultez Attributs.
| Attribut | S’applique à | Spécifie |
|---|---|---|
| SoapAttributeAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le membre de classe est sérialisé en tant qu'attribut XML. |
| SoapElementAttribute | Champ public, propriété, paramètre ou valeur de retour. | La classe est sérialisée en tant qu'élément XML. |
| SoapEnumAttribute | Champ public qui est un identificateur d'énumération. | Nom d'élément d'un membre d'énumération. |
| SoapIgnoreAttribute | Champs et propriétés publics. | La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée. |
| SoapIncludeAttribute | Déclarations de classe dérivée publiques et méthodes publiques pour les documents WSDL (Web Services Description Language). | Le type doit être inclus lors de la génération de schémas (afin d'être reconnu en cas de sérialisation). |
| SoapTypeAttribute | Déclarations de classe publiques. | La classe doit être sérialisée en tant que type XML. |
