Partager via


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

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.

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

XmlSerializer

Autres ressources

Sérialisation XML et SOAP
Extending Metadata Using Attributes