SoapDocumentServiceAttribute 类

定义

将可选的 SoapDocumentServiceAttribute 应用于 XML Web services 时,将设置在 XML Web services 内发送到 XML Web services 方法的 SOAP 请求和从 XML Web services 方法发回的 SOAP 响应的默认格式。Applying the optional SoapDocumentServiceAttribute to an XML Web service sets the default format of SOAP requests and responses sent to and from XML Web service methods within the XML Web service.

public ref class SoapDocumentServiceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
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 Web service 中 XML Web service 方法设置默认格式设置样式。The SoapDocumentServiceAttribute allows you to set the default formatting styles for XML Web service methods within an XML Web service. 如果单个 XML Web service 方法必须更改这些默认设置, 请将SoapDocumentMethodAttribute应用于该 XML Web service 方法。If an individual XML Web service method must change these defaults, apply a SoapDocumentMethodAttribute to that XML Web service method.

Web 服务描述语言 (WSDL) 定义了两种样式, 可用于在 soap 请求或 soap 响应中格式化 XML Web service 方法 (该方法调用操作): RPC和。 DocumentWeb Services Description Language (WSDL) defines two styles for how an XML Web service method, which it calls an operation, can be formatted in a SOAP request or a SOAP response: RPC and Document. UseParameterStyle属性确定各个消息部分的具体方式。Exactly how the individual message parts is determined by the Use and ParameterStyle properties. 属性确定参数的格式Encoded是否为或LiteralUseThe Use property determines whether parameters are formatted Encoded or Literal. 确定是否将参数封装到Body元素下的单个消息部分, 或者每个参数是否是单个消息部分。 ParameterStyleThe ParameterStyle determines whether the parameters are encapsulated within a single message part beneath the Body element, or whether each parameter is an individual message part.

若要将默认的方法级别格式RPC设置为, SoapRpcServiceAttribute请将应用于实现 XML Web service 的类。To set the default method level formatting to RPC, apply a SoapRpcServiceAttribute to the class implementing the XML Web service.

有关更多详细信息, 请参阅自定义 SOAP 消息格式For more details, see Customizing SOAP Message Formatting.

此特性可应用于实现 XML Web service 的类。This attribute can be applied to a class implementing an XML Web service.

构造函数

SoapDocumentServiceAttribute()

初始化 SoapDocumentServiceAttribute 类的新实例,将所有属性都设置为其默认值。Initializes a new instance of the SoapDocumentServiceAttribute class setting all properties to their default values.

SoapDocumentServiceAttribute(SoapBindingUse)

初始化 SoapDocumentServiceAttribute 类的新实例,设置参数的格式设置。Initializes a new instance of the SoapDocumentServiceAttribute class setting the parameter formatting.

SoapDocumentServiceAttribute(SoapBindingUse, SoapParameterStyle)

初始化 SoapDocumentServiceAttribute 类的新实例,该类设置参数的格式设置并设置参数是否封装在 SOAP 消息中的 Body 元素下的单个 XML 元素中。Initializes a new instance of the SoapDocumentServiceAttribute class that sets the parameter formatting and sets whether parameters are encapsulated within a single XML element, under the Body element, in SOAP messages.

属性

ParameterStyle

获取或设置用来控制参数是否封装在 XML Web services 的 XML Web services 方法的 SOAP 消息 XML 部分中 <Body> 元素之后的单个元素中的默认设置。Gets or sets the default setting that controls whether parameters are encapsulated within a single element following the <Body> element in the XML portion of a SOAP message for XML Web service methods of the XML Web service.

RoutingStyle

获取或设置将 SOAP 消息发送到 XML Web services 的方式。Gets or sets how SOAP messages are routed to the XML Web service.

TypeId

在派生类中实现时,获取此 Attribute 的唯一标识符。When implemented in a derived class, gets a unique identifier for this Attribute.

(继承自 Attribute)
Use

获取或设置 XML Web services 的默认参数格式设置。Gets or sets the default parameter formatting for an XML Web service.

方法

Equals(Object)

返回一个值,该值指示此实例是否与指定的对象相等。Returns a value that indicates whether this instance is equal to a specified object.

(继承自 Attribute)
GetHashCode()

返回此实例的哈希代码。Returns the hash code for this instance.

(继承自 Attribute)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
IsDefaultAttribute()

在派生类中重写时,指示此实例的值是否是派生类的默认值。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(继承自 Attribute)
Match(Object)

当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(继承自 Attribute)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)

显式接口实现

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

将一组名称映射为对应的一组调度标识符。Maps a set of names to a corresponding set of dispatch identifiers.

(继承自 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

检索对象的类型信息,然后可以使用该信息获取接口的类型信息。Retrieves the type information for an object, which can be used to get the type information for an interface.

(继承自 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

检索对象提供的类型信息接口的数量(0 或 1)。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(继承自 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供对某一对象公开的属性和方法的访问。Provides access to properties and methods exposed by an object.

(继承自 Attribute)

适用于

另请参阅