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
- Наследование
- Атрибуты
Примеры
<%@ 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-элементе |
| SoapDocumentServiceAttribute(SoapBindingUse) |
Инициализирует новый экземпляр SoapDocumentServiceAttribute класса, задающий форматирование параметров. |
Свойства
| Имя | Описание |
|---|---|
| ParameterStyle |
Возвращает или задает параметр по умолчанию, который определяет, инкапсулируются ли параметры в одном элементе после |
| 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) |