SoapDocumentServiceAttribute Класс

Ссылка

Определение

Пространство имен:: System.Web.Services.Protocols

Сборка:: System.Web.Services.dll

Важно!

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

При применении необязательного атрибута 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

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

Attribute
SoapDocumentServiceAttribute

Атрибуты: AttributeUsageAttribute

Примеры

<%@ 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)

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

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