SoapDocumentServiceAttribute 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将可选的 SoapDocumentServiceAttribute 应用于 XML Web services 时，将设置在 XML Web services 内发送到 XML Web services 方法的 SOAP 请求和从 XML Web services 方法发回的 SOAP 响应的默认格式。
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 AttributePublic 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 Web 服务中设置 XML Web 服务方法的默认格式样式。 如果单个 XML Web 服务方法必须更改这些默认值，请将 应用于 SoapDocumentMethodAttribute 该 XML Web 服务方法。
Web Services Description Language (WSDL) 为 XML Web service 方法（它调用操作）在 SOAP 请求或 SOAP 响应中设置格式定义了两种样式： RPC 和 Document。 各个消息部分的确切方式由 Use 和 ParameterStyle 属性确定。 属性Use确定参数是格式化EncodedLiteral还是 。 确定 ParameterStyle 参数是否封装在 元素下的 Body 单个消息部分内，或者每个参数是否为单独的消息部分。
若要将默认方法级别格式设置为 RPC，请将 应用于 SoapRpcServiceAttribute 实现 XML Web 服务的类。
有关详细信息，请参阅 自定义 SOAP 消息格式。
此属性可应用于实现 XML Web 服务的类。
构造函数
| SoapDocumentServiceAttribute() |
初始化 SoapDocumentServiceAttribute 类的新实例，将所有属性都设置为其默认值。 |
| SoapDocumentServiceAttribute(SoapBindingUse) |
初始化 SoapDocumentServiceAttribute 类的新实例，设置参数的格式设置。 |
| SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle) |
初始化 SoapDocumentServiceAttribute 类的新实例，该类设置参数的格式设置并设置参数是否封装在 SOAP 消息中的 |
属性
| ParameterStyle |
获取或设置用来控制参数是否封装在 XML Web services 的 XML Web services 方法的 SOAP 消息 XML 部分中 |
| RoutingStyle |
获取或设置将 SOAP 消息发送到 XML Web services 的方式。 |
| TypeId |
在派生类中实现时，获取此 Attribute 的唯一标识符。 (继承自 Attribute) |
| Use |
获取或设置 XML Web services 的默认参数格式设置。 |
方法
| 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) |
