Attributs qui contrôlent la sérialisation encodée selon le protocole SOAP
Le document World Wide Web Consortium (www.w3.org) intitulé « Simple Object Access Protocol (SOAP) 1.1 » contient une section facultative (section 5) qui décrit la manière dont les paramètres SOAP peuvent être encodés. Pour se conformer à la section 5 de la spécification, vous devez utiliser un ensemble spécial d'attributs se trouvant 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 Comment : sérialiser un objet en tant que flux XML encodé selon le protocole SOAP et Comment : substituer la sérialisation XML encodée selon le protocole SOAP.
Pour plus d'informations sur les attributs, consultez Extending Metadata Using Attributes.
Attribut | S'applique à | Informations fournies |
---|---|---|
Champ public, propriété, paramètre ou valeur de retour. |
Le membre de classe est sérialisé en tant qu'attribut XML. |
|
Champ public, propriété, paramètre ou valeur de retour. |
La classe est sérialisée en tant qu'élément XML. |
|
Champ public qui est un identificateur d'énumération. |
Nom d'élément d'un membre d'énumération. |
|
Champs et propriétés publics. |
La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée. |
|
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). |
|
Déclarations de classe publiques. |
La classe doit être sérialisée en tant que type XML. |
Voir aussi
Tâches
Comment : sérialiser un objet en tant que flux XML encodé selon le protocole SOAP
Comment : substituer la sérialisation XML encodée selon le protocole SOAP
Comment : sérialiser un objet
Comment : désérialiser un objet
Référence
Autres ressources
Sérialisation XML et SOAP
Extending Metadata Using Attributes