Поделиться через


SoapHeaderDirection Перечисление

Определение

Указывает, является ли получатель SoapHeader веб-службой XML, клиентом веб-службы XML или обоими.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
[<System.Flags>]
type SoapHeaderDirection = 
Public Enum SoapHeaderDirection
Наследование
SoapHeaderDirection
Атрибуты

Поля

Fault 4

Указывает SoapHeader отправляется клиенту веб-службы XML при возникновении исключения методом веб-службы XML.

In 1

Указывает SoapHeader отправляется в веб-службу XML.

InOut 3

Указывает SoapHeader отправляется как веб-службе XML, так и клиенту веб-службы XML.

Out 2

Указывает SoapHeader отправляется клиенту веб-службы XML.

Примеры

Следующий метод веб-службы XML указывает, что myHeaderSoapHeader отправляется из клиента веб-службы XML в веб-службу XML, а затем возвращается клиенту веб-службы XML независимо от исключения, возникающего во время выполнения метода веб-службы XML.

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, либо к методу прокси-класса к веб-службе XML. В любом случае получатели задаются свойством SoapHeaderAttribute.Direction. Чтобы указать, что метод веб-службы XML возвращает заголовок SOAP при возникновении исключения во время его выполнения, примените SoapHeaderAttribute к методу и задайте для свойства SoapHeaderAttribute.Direction значение Fault.

Применяется к

См. также раздел