Attributs qui contrôlent la sérialisation encodée selon le protocole SOAPAttributes That Control Encoded SOAP Serialization

Le document du World Wide Web Consortium (W3C) nommé Simple objet Access Protocol (SOAP) 1.1 contient une section facultative (section 5) qui décrit la façon dont les paramètres SOAP peuvent être encodés.The World Wide Web Consortium (W3C) document named Simple Object Access Protocol (SOAP) 1.1 contains an optional section (section 5) that describes how SOAP parameters can be encoded. 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.To conform to section 5 of the specification, you must use a special set of attributes found in the System.Xml.Serialization namespace. Appliquez ces attributs en fonction des classes et membres de classes, puis utilisez XmlSerializer pour sérialiser les instances de la ou des classes.Apply those attributes as appropriate to classes and members of classes, and then use the XmlSerializer to serialize instances of the class or classes.

Le tableau suivant affiche les attributs, leurs conditions d'application et l'action qu'ils entraînent.The following table shows the attributes, where they can be applied, and what they do. Pour plus d’informations sur l’utilisation de ces attributs pour contrôler la sérialisation XML, consultez Comment : Sérialiser un objet comme un Stream XML encodés en SOAP et Comment : Substituer la sérialisation du XML SOAP encodé.For more information about using these attributes to control XML serialization, see How to: Serialize an Object as a SOAP-Encoded XML Stream and How to: Override Encoded SOAP XML Serialization.

Pour plus d’informations sur les attributs, consultez Attributs.For more information about attributes, see Attributes.

AttributAttribute S'applique àApplies to Informations fourniesSpecifies
SoapAttributeAttribute Champ public, propriété, paramètre ou valeur de retour.Public field, property, parameter, or return value. Le membre de classe est sérialisé en tant qu'attribut XML.The class member will be serialized as an XML attribute.
SoapElementAttribute Champ public, propriété, paramètre ou valeur de retour.Public field, property, parameter, or return value. La classe est sérialisée en tant qu'élément XML.The class will be serialized as an XML element.
SoapEnumAttribute Champ public qui est un identificateur d'énumération.Public field that is an enumeration identifier. Nom d'élément d'un membre d'énumération.The element name of an enumeration member.
SoapIgnoreAttribute Champs et propriétés publics.Public properties and fields. La propriété ou le champ doit être ignoré lorsque la classe conteneur est sérialisée.The property or field should be ignored when the containing class is serialized.
SoapIncludeAttribute Déclarations de classe dérivée publiques et méthodes publiques pour les documents WSDL (Web Services Description Language).Public-derived class declarations and public methods for Web Services Description Language (WSDL) documents. Le type doit être inclus lors de la génération de schémas (afin d'être reconnu en cas de sérialisation).The type should be included when generating schemas (to be recognized when serialized).
SoapTypeAttribute Déclarations de classe publiques.Public class declarations. La classe doit être sérialisée en tant que type XML.The class should be serialized as an XML type.

Voir aussiSee also