SoapHeaderDirection 枚举

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

指定 SoapHeader 的接收者是 XML Web services、XML Web services 客户端还是两者都是。

此枚举支持其成员值的按位组合。

public enum class SoapHeaderDirection

[System.Flags]
public enum SoapHeaderDirection

[<System.Flags>]
type SoapHeaderDirection = 

Public Enum SoapHeaderDirection

继承

Object

ValueType

Enum

SoapHeaderDirection

属性

FlagsAttribute

字段

Fault	4	指定 XML Web services 方法引发错误时，将 SoapHeader 发送到 XML Web services 客户端。
In	1	指定将 SoapHeader 发送到 XML Web services。
InOut	3	指定将 SoapHeader 发送到 XML Web services 和 XML Web services 客户端。
Out	2	指定将 SoapHeader 发送到 XML Web services 客户端。

示例

以下 XML Web 服务方法指定 myHeaderSoapHeader 从 XML Web 服务客户端发送到 XML Web 服务，然后返回 XML Web 服务客户端，而不考虑执行 XML Web 服务方法期间引发的异常。

public ref class MyHeader: public SoapHeader
{
public:
   String^ MyValue;
};

public ref class MyWebService
{
public:
   MyHeader^ myHeader;

   [WebMethod]
   [SoapHeader("myHeader",
   Direction=SoapHeaderDirection::InOut|SoapHeaderDirection::Fault)]
   void MySoapHeaderReceivingMethod()
   {
      
      // Set myHeader->MyValue to some value.
   }

};

public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader",
                Direction=SoapHeaderDirection.InOut | SoapHeaderDirection.Fault)]
    public void MySoapHeaderReceivingMethod() {

        // Set myHeader.MyValue to some value.
    }
}

Public Class MyHeader
    Inherits SoapHeader
    Public MyValue As String
End Class

Public Class MyWebService
    
    Public myHeader As MyHeader    
    
    <WebMethod, _
    SoapHeader("myHeader", _
                Direction := SoapHeaderDirection.InOut Or SoapHeaderDirection.Fault)> _
    Public Sub MySoapHeaderReceivingMethod()

        ' Set myHeader.MyValue to some value.
        
    End Sub
    
End Class

注解

SoapHeaderAttribute可以应用于 XML Web 服务方法，也可以将代理类的方法应用于 XML Web 服务。 在任一情况下，收件人都由 SoapHeaderAttribute.Direction 属性指定。 若要指定 XML Web 服务方法在执行过程中引发异常时返回 SOAP 标头，请将 应用于 SoapHeaderAttribute 方法并将 属性 SoapHeaderAttribute.Direction 设置为 Fault。

另请参阅

• SoapHeaderAttribute
• SoapHeader