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


SoapDocumentServiceAttribute Класс

Определение

Применение необязательного SoapDocumentServiceAttribute к веб-службе XML задает формат запросов и ответов SOAP по умолчанию, отправляемых и от методов веб-службы XML в веб-службе 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 определяет, форматируются Encoded ли параметры или Literal. Определяет ParameterStyle , инкапсулируются ли параметры в одной части сообщения под Body элементом или является ли каждый параметр отдельной частью сообщения.

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

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

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

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

Имя Описание
SoapDocumentServiceAttribute()

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

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

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

SoapDocumentServiceAttribute(SoapBindingUse)

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

Свойства

Имя Описание
ParameterStyle

Возвращает или задает параметр по умолчанию, который определяет, инкапсулируются ли параметры в одном элементе после <Body> элемента в XML-части сообщения SOAP для методов веб-службы 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)

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

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