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

Ссылка

Определение

Пространство имен:: System.Web.Services.Protocols

Сборка:: System.Web.Services.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

public enum class SoapHeaderDirection

[System.Flags]
public enum SoapHeaderDirection

[<System.Flags>]
type SoapHeaderDirection =

Public Enum SoapHeaderDirection

Наследование: Object

ValueType

Enum
SoapHeaderDirection

Атрибуты: FlagsAttribute

Поля

Имя	Значение	Описание
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.

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

Продукт	Версии
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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

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

Определение

Поля

Примеры

Комментарии

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

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

Дополнительные ресурсы