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


SoapDocumentServiceAttribute Класс

Определение

При применении необязательного атрибута SoapDocumentServiceAttribute к веб-службе XML устанавливается формат по умолчанию для запросов и ответов SOAP, которыми обмениваются методы в пределах веб-службы XML.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class)>]
type SoapDocumentServiceAttribute = class
    inherit Attribute
Public NotInheritable Class SoapDocumentServiceAttribute
Inherits Attribute
Наследование
SoapDocumentServiceAttribute
Атрибуты

Примеры

<%@ WebService Language="c#" Class="SumService" %>

using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }
    }
<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             RoutingStyle := SoapServiceRoutingStyle.SoapAction)> _
    Public Class SumService 
          Inherits System.Web.Services.WebService
    
        <WebMethod> _
        Public Function Add(a As Integer, b as Integer)
           return a + b
        End Function
    End Class

Комментарии

Позволяет SoapDocumentServiceAttribute задать стили форматирования по умолчанию для методов веб-службы XML в веб-службе XML. Если отдельный метод веб-службы XML должен изменить эти значения по умолчанию, примените к нему SoapDocumentMethodAttribute метод веб-службы XML.

Язык описания веб-служб (WSDL) определяет два стиля для форматирования метода веб-службы XML, вызываемого операцией, в запросе SOAP или ответе SOAP: RPC и Document. Точно, как отдельные части сообщения определяются свойствами Use и ParameterStyle . Свойство Use определяет, имеют ли параметры формат или EncodedLiteral. Определяет ParameterStyle , инкапсулируются ли параметры в отдельной части сообщения под элементом Body или каждый параметр является отдельной частью сообщения.

Чтобы задать форматирование RPCна уровне метода по умолчанию , примените SoapRpcServiceAttribute к классу, реализуя веб-службу XML.

Дополнительные сведения см. в разделе Настройка форматирования сообщений SOAP.

Этот атрибут можно применить к классу, реализуя веб-службу XML.

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

SoapDocumentServiceAttribute()

Инициализирует новый экземпляр класса SoapDocumentServiceAttribute, устанавливая для всех свойств значения по умолчанию.

SoapDocumentServiceAttribute(SoapBindingUse)

Инициализирует новый экземпляр класса SoapDocumentServiceAttribute, устанавливающий форматирование параметров.

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

Инициализирует новый экземпляр класса SoapDocumentServiceAttribute, который устанавливает форматирование параметров и задает значение, указывающее, инкапсулированы ли параметры в одном элементе XML, следующем после элемента Body в сообщениях SOAP.

Свойства

ParameterStyle

Получает или задает настройку по умолчанию, указывающую, инкапсулированы ли параметры в одном элементе, следующем за элементом <Body> в XML-части сообщения SOAP, предназначенном для методов веб-службы XML в пределах веб-службы XML.

RoutingStyle

Получает или задает значение, указывающее способ маршрутизации сообщений SOAP к веб-службе XML.

TypeId

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

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

Получает или задает форматирование параметров по умолчанию для веб-службы XML.

Методы

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)

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

См. также раздел