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" 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, voir Comment : Sérialiser un objet en tant que flux XML codé en SOAP et Comment : Substituer la sérialisation XML codée en SOAP.
Pour plus d'informations sur les attributs, voir Extending Metadata Using Attributes.
Attribut | Application à | Informations fournies |
---|---|---|
Champ public, propriété, paramètre ou valeur de retour. |
Le membre de classe sera sérialisé en tant qu'attribut XML. |
|
Champ public, propriété, paramètre ou valeur de retour. |
La classe sera 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 de l'é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 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). |
|
Déclarations de classe publique. |
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 codé en SOAP
Comment : Substituer la sérialisation XML codée en 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