SoapHeaderDirection Enumeração

Definição

Espaço de Nomes:
System.Web.Services.Protocols
Assemblagem:
System.Web.Services.dll

Especifica se o destinatário do SoapHeader é o serviço Web XML, o cliente do serviço Web XML, ou ambos.

Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.

public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
[<System.Flags>]
type SoapHeaderDirection = 
Public Enum SoapHeaderDirection
Herança
Object
ValueType
Enum
SoapHeaderDirection
Atributos
FlagsAttribute

Campos

Name Valor Description
In 1

Especifica que é SoapHeader enviado para o serviço Web XML.
Out 2

Especifica que é SoapHeader enviado para o cliente de serviço Web XML.
InOut 3

Especifica que é SoapHeader enviado tanto para o serviço Web XML como para o cliente do serviço Web XML.
Fault 4

Especifica que é SoapHeader enviado para o cliente do serviço Web XML quando uma exceção é lançada pelo método do serviço Web XML.

Exemplos

O seguinte método de serviço Web XML especifica que o myHeaderSoapHeader é enviado do cliente do serviço Web XML para o serviço Web XML e depois de volta para o cliente do serviço Web XML, independentemente de uma exceção lançada durante a execução do método do serviço Web 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

Observações

A SoapHeaderAttribute pode ser aplicado a um método de serviço Web XML ou a um método de classe proxy para um serviço Web XML. Em qualquer dos casos, os destinatários são especificados pela SoapHeaderAttribute.Direction propriedade. Para especificar que um método de serviço Web XML devolve um cabeçalho SOAP quando uma exceção é lançada durante a sua execução, aplique a SoapHeaderAttribute ao método e defina a SoapHeaderAttribute.Direction propriedade para Fault.

Aplica-se a

Ver também