SoapHeaderDirection 枚举

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

指定 SoapHeader 的接收方是 XML Web 服务、XML Web 服务客户端还是两者。

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

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 服务方法引发异常时，SoapHeader 将发送到 XML Web 服务客户端。
In	1	指定将 SoapHeader 发送到 XML Web 服务。
InOut	3	指定 SoapHeader 同时发送到 XML Web 服务和 XML Web 服务客户端。
Out	2	指定将 SoapHeader 发送到 XML Web 服务客户端。

示例

以下 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