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


SoapIncludeAttribute Класс

Определение

Позволяет 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.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
[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)>]
type SoapIncludeAttribute = class
    inherit Attribute
Public Class SoapIncludeAttribute
Inherits Attribute
Наследование
SoapIncludeAttribute
Атрибуты

Примеры

В следующем примере дважды применяется 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)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.

(Унаследовано от Attribute)

Применяется к