Attributs qui contrôlent la sérialisation codée en SOAP
Le document du World Wide Web Consortium (www.w3.org) intitulé « Simple Object Access Protocol (SOAP) 1.1 » (en anglais) contient une section facultative (section 5) qui décrit la manière dont les paramètres SOAP peuvent être codés. Pour se conformer à la section 5 de la spécification, vous devez utiliser un ensemble spécial d'attributs qui se trouve dans l'espace de noms System.Xml.Serialization. Appliquez ces attributs aux classes et membres de classes selon les cas, puis utilisez XmlSerializer pour sérialiser des instances de la classe ou des classes.
Le tableau suivant répertorie les attributs, leurs champs d'applications et leurs rôles. Pour plus d'informations sur l'utilisation de ces attributs pour contrôler la sérialisation XML, consultez Génération de messages SOAP à l'aide de la sérialisation XML.
Pour plus d'informations sur les attributs, consultez Extension des métadonnées à l'aide des attributs.
| Attribut | Application à | Spécifie |
|---|---|---|
| SoapAttributeAttribute | Champ public, propriété, paramètre ou valeur de retour. | Le membre de classe sera sérialisé en tant qu'attribut XML. |
| SoapElementAttribute | Champ public, propriété, paramètre ou valeur de retour. | La classe sera sérialisée en tant qu'élément XML. |
| SoapEnumAttribute | Champ public qui est un identificateur d'énumération. | Le nom d'élément d'un membre d'une é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 publique, et méthodes publiques pour des documents WSDL (Web Service Description Language). | Le type doit être inclus lors de la génération de schémas (à reconnaître lors de la sérialisation). |
| SoapTypeAttribute | Déclarations de classe publique. | La classe doit être sérialisée en tant que type XML. |
Voir aussi
Sérialisation XML et SOAP | Génération de messages SOAP à l'aide de la sérialisation XML | Extension des métadonnées à l'aide des attributs | XmlSerializer