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

В документе «Simple Object Access Protocol (SOAP) 1.1» консорциума World Wide Web Consortium (www.w3.org) содержится дополнительный раздел (раздел 5), в котором описаны способы кодирования параметров SOAP. Для соответствия разделу 5 спецификации следует использовать специальный набор атрибутов, расположенный в пространстве имен System.Xml.Serialization. Примените эти атрибуты для соответствующих классов и членов классов, а затем используйте XmlSerializer для сериализации экземпляров класса или классов.

В следующей таблице показаны атрибуты, место их применения и выполняемые ими действия. Дополнительные сведения об использовании этих атрибутов для управления XML-сериализацией см. в разделах Как сериализовать объект как поток XML с кодировкой SOAP и Как переопределить XML-сериализацию с кодировкой SOAP.

Дополнительные сведения об атрибутах см. в разделе Extending Metadata Using Attributes.

Атрибут Применимость Что определяет

SoapAttributeAttribute

Открытое поле, свойство, параметр или возвращаемое значение.

Член класса должен быть сериализован как атрибут XML.

SoapElementAttribute

Открытое поле, свойство, параметр или возвращаемое значение.

Класс должен быть сериализован как элемент XML.

SoapEnumAttribute

Открытое поле, являющееся идентификатором перечисления.

Имя элемента члена перечисления.

SoapIgnoreAttribute

Открытые свойства и поля.

Свойство или поле должно игнорироваться при сериализации содержащего его класса.

SoapIncludeAttribute

Объявления открытых производных классов и открытые методы для документов WSDL.

При создании схем должен быть включен тип (чтобы его можно было распознать во время сериализации).

SoapTypeAttribute

Объявления открытых классов.

Класс должен быть сериализован как тип XML.

См. также

Задачи

Как сериализовать объект как поток XML с кодировкой SOAP
Как переопределить XML-сериализацию с кодировкой SOAP
Как сериализовать объект
Как десериализовать объект

Справочник

XmlSerializer

Другие ресурсы

XML- и SOAP-сериализация
Extending Metadata Using Attributes