Поделиться через


Атрибуты, управляющие сериализацией закодированного SOAP

Документ консорциума W3C с именем Simple Object Access Protocol (SOAP) 1.1 содержит дополнительный раздел (раздел 5), описывающий кодирование параметров SOAP. Чтобы соответствовать разделу 5 спецификации, необходимо использовать специальный набор атрибутов, найденных в System.Xml.Serialization пространстве имен. Примените эти атрибуты к классам и членам классов, а затем используйте XmlSerializer для сериализации экземпляров класса или классов.

В следующей таблице показаны атрибуты, где их можно применить, и то, что они делают. Дополнительные сведения об использовании этих атрибутов для управления сериализацией XML см. в статье "Практическое руководство. Сериализация объекта в виде xml-потока SOAP-Encoded и практическое руководство. Переопределение закодированной XML-сериализации SOAP".

Дополнительные сведения об атрибутах см. в разделе "Атрибуты".

Свойство Применимо к Указывает
SoapAttributeAttribute Общедоступное поле, свойство, параметр или возвращаемое значение. Член класса будет сериализован в виде XML-атрибута.
SoapElementAttribute Общедоступное поле, свойство, параметр или возвращаемое значение. Класс будет сериализован как XML-элемент.
SoapEnumAttribute Общедоступное поле, которое является идентификатором перечисления. Имя элемента члена перечисления.
SoapIgnoreAttribute Общедоступные свойства и поля. Свойство или поле следует игнорировать при сериализации содержащего класса.
SoapIncludeAttribute Объявления общедоступных классов и общедоступные методы для документов языка описания веб-служб (WSDL). Тип должен быть включен при создании схем (для распознавания при сериализации).
SoapTypeAttribute Объявления открытых классов. Класс должен быть сериализован как тип XML.

См. также