SoapHeaderDirection SoapHeaderDirection SoapHeaderDirection SoapHeaderDirection Enum

Определение

Указывает, является получатель SoapHeader веб-службой XML, клиентом веб-службы XML или и тем, и другим.Specifies whether the recipient of the SoapHeader is the XML Web service, the XML Web service client, or both.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

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

Поля

Fault Fault Fault Fault 4

Указывает, что SoapHeader посылается клиенту веб-службы XML в момент выдачи исключения методом веб-службы XML.Specifies the SoapHeader is sent to the XML Web service client when an exception is thrown by the XML Web service method.

In In In In 1

Указывает, что SoapHeader посылается веб-службе XML.Specifies the SoapHeader is sent to the XML Web service.

InOut InOut InOut InOut 3

Указывает, что SoapHeader посылается веб-службе XML и клиенту веб-службы XML.Specifies the SoapHeader is sent to both the XML Web service and the XML Web service client.

Out Out Out Out 2

Указывает, что SoapHeader посылается клиенту веб-службы XML.Specifies the SoapHeader is sent to the XML Web service client.

Примеры

Следующий метод XML-веб-службы указывает, что myHeader Fault отправляются от клиента XML-веб-службы XML-веб-службу и затем обратно клиенту XML-веб-службы, независимо от того, исключение, выданное при выполнении XML-веб-службы метод.The following XML Web service method specifies that the myHeaderFault is sent from the XML Web service client to the XML Web service and then back to the XML Web service client, regardless of an exception thrown during execution of the XML Web service method.

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.A SoapHeaderAttribute can be applied to either an XML Web service method or a method of a proxy class to an XML Web service. В любом случае получатели задаются Direction свойство SoapHeaderAttribute.In either case, the recipient(s) are specified by the Direction property of SoapHeaderAttribute. Чтобы указать, что к методу XML-веб-службы возвращает заголовок SOAP, если возникает исключение во время его выполнения, примените SoapHeaderAttribute в метод и задайте Direction свойство сбоем.To specify that an XML Web service method returns a SOAP header when an exception is thrown during its execution, apply an SoapHeaderAttribute to the method and set the Direction property to Fault.

Платформа .NET Framework версии 1.0 не поддерживает значение ошибки.Version 1.0 of the .NET Framework does not support the Fault value.

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

Дополнительно