Атрибуты управления сериализацией с кодировкой SOAP
В разделе номер 5 документа Simple Object Access Protocol (SOAP) 1.1 описаны способы кодирования параметров SOAP. Для соответствия разделу 5 спецификации следует использовать специальный набор атрибутов, расположенный в пространстве имен System.Xml.Serialization. Примените эти атрибуты для соответствующих классов и членов классов, а затем используйте XmlSerializer для сериализации экземпляров класса или классов.
В следующей таблице показаны атрибуты, место их применения и выполняемые ими действия. Дополнительные сведения об использовании этих атрибутов для управления XML-сериализации см. в разделах Практическое руководство. Сериализация объекта как потока XML с кодировкой SOAP и Практическое руководство. Переопределение сериализации XML с кодировкой SOAP.
Дополнительные сведения об атрибутах см. в разделе Атрибуты.
Атрибут | Применяется к | Указывает |
---|---|---|
SoapAttributeAttribute | Открытое поле, свойство, параметр или возвращаемое значение. | Член класса должен быть сериализован как атрибут XML. |
SoapElementAttribute | Открытое поле, свойство, параметр или возвращаемое значение. | Класс должен быть сериализован как элемент XML. |
SoapEnumAttribute | Открытое поле, являющееся идентификатором перечисления. | Имя элемента члена перечисления. |
SoapIgnoreAttribute | Открытые свойства и поля. | Свойство или поле должно игнорироваться при сериализации содержащего его класса. |
SoapIncludeAttribute | Объявления открытых производных классов и открытые методы для документов WSDL. | При создании схем должен быть включен тип (чтобы его можно было распознать во время сериализации). |
SoapTypeAttribute | Объявления открытых классов. | Класс должен быть сериализован как тип XML. |