SoapIncludeAttribute Класс

Определение

Пространство имен:

System.Xml.Serialization

Сборка:

System.Xml.XmlSerializer.dll

Исходный код:

SoapIncludeAttribute.cs

Позволяет XmlSerializer распознавать тип при сериализации или десериализации объекта согласно кодированию SOAP XML.

public ref class SoapIncludeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute

Public Class SoapIncludeAttribute
Inherits Attribute

Наследование

Object

Attribute

SoapIncludeAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере дважды применяется SoapIncludeAttribute к методу веб-службы XML. Метод возвращает объект типа Vehicle (базовый класс). позволяет SoapIncludeAttribute методу возвращать экземпляры классов, производных от Vehicle класса .

Комментарии

Класс SoapIncludeAttribute принадлежит к семейству атрибутов, которые управляют XmlSerializer сериализацией или десериализацией объекта в виде закодированного XML-кода SOAP. Результирующий XML-код соответствует разделу 5 документа консорциума World Wide Web ( Протокол SOAP 1.1). Полный список аналогичных атрибутов см. в разделе Атрибуты, управляющие закодированной сериализацией SOAP.

Чтобы сериализовать объект как закодированное сообщение SOAP, необходимо создать XmlSerializer с помощью , созданного ImportTypeMappingSoapReflectionImporter с помощью XmlTypeMapping метода класса .

При применении SoapIncludeAttributeукажите Type для производного класса. XmlSerializer При сериализации объектов, включающих как базовый, так и производный класс, он может распознать оба типа объектов.

Можно использовать для SoapIncludeAttribute включения производных классов в документы описания служб, написанные на языке WSDL. Например, если метод возвращает Object, примените SoapIncludeAttribute к методу и укажите фактические типы, которые должны быть возвращены.

Дополнительные сведения о WSDL см. в разделе Спецификация консорциума World Wide Web , Язык описания веб-служб (WSDL) 1.1.

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

Конструкторы

SoapIncludeAttribute(Type)

Инициализирует новый экземпляр класса SoapIncludeAttribute, используя указанный тип.

Свойства

Type	Получает или задает тип объекта для использования при сериализации или десериализации объекта.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)