Attributes That Control Encoded SOAP Serialization
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. To conform to section 5 of the specification, you must use a special set of attributes found in the System.Xml.Serialization namespace. Apply those attributes as appropriate to classes and members of classes, and then use the XmlSerializer to serialize instances of the class or classes.
The following table shows the attributes, where they can be applied, and what they do. 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.
For more information about attributes, see Attributes.
| Attribute | Applies to | Specifies |
|---|---|---|
| SoapAttributeAttribute | Public field, property, parameter, or return value. | The class member will be serialized as an XML attribute. |
| SoapElementAttribute | Public field, property, parameter, or return value. | The class will be serialized as an XML element. |
| SoapEnumAttribute | Public field that is an enumeration identifier. | The element name of an enumeration member. |
| SoapIgnoreAttribute | Public properties and fields. | The property or field should be ignored when the containing class is serialized. |
| SoapIncludeAttribute | Public-derived class declarations and public methods for Web Services Description Language (WSDL) documents. | The type should be included when generating schemas (to be recognized when serialized). |
| SoapTypeAttribute | Public class declarations. | The class should be serialized as an XML type. |
