SoapHeaderDirection SoapHeaderDirection SoapHeaderDirection SoapHeaderDirection Enum

Definition

Gibt an, ob der Empfänger von SoapHeader der XML-Webdienst oder der XML-Webdienstclient bzw. sowohl XML-Webdienst als auch der XML-Webdienstclient ist.Specifies whether the recipient of the SoapHeader is the XML Web service, the XML Web service client, or both.

Diese Enumeration weist ein FlagsAttribute-Attribut auf, die eine bitweise Kombination der Memberwerte zulässt.

public enum class SoapHeaderDirection
[System.Flags]
public enum SoapHeaderDirection
type SoapHeaderDirection = 
Public Enum SoapHeaderDirection
Vererbung
SoapHeaderDirectionSoapHeaderDirectionSoapHeaderDirectionSoapHeaderDirection
Attribute

Felder

Fault Fault Fault Fault 4

Legt fest, dass der SoapHeader beim Auslösen einer Ausnahme durch die XML-Webdienstmethode an den XML-Webdienstclient gesendet wird.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

Gibt an, dass SoapHeader an den XML-Webdienst gesendet wird.Specifies the SoapHeader is sent to the XML Web service.

InOut InOut InOut InOut 3

Gibt an, dass SoapHeader an den XML-Webdienst und den XML-Webdienstclient gesendet wird.Specifies the SoapHeader is sent to both the XML Web service and the XML Web service client.

Out Out Out Out 2

Gibt an, dass SoapHeader an den XML-Webdienstclient gesendet wird.Specifies the SoapHeader is sent to the XML Web service client.

Beispiele

Die folgende XML-Webdienst Methode gibt an myHeader , dass der SoapHeader vom XML-Webdienst Client an den XML-Webdienst und dann zurück an den XML-Webdienst Client gesendet wird, unabhängig von einer Ausnahme, die während der Ausführung des XML-Webdiensts ausgelöst wird. anzuwenden.The following XML Web service method specifies that the myHeader SoapHeader 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

Hinweise

Ein SoapHeaderAttribute kann entweder auf eine XML-Webdienst Methode oder eine Methode einer Proxy Klasse für einen XML-Webdienst angewendet werden.A SoapHeaderAttribute can be applied to either an XML Web service method or a method of a proxy class to an XML Web service. In beiden Fällen werden die Empfänger durch die SoapHeaderAttribute.Direction -Eigenschaft angegeben.In either case, the recipients are specified by the SoapHeaderAttribute.Direction property. Um anzugeben, dass eine XML-Webdienst Methode einen SOAP-Header zurückgibt, wenn während der Ausführung eine Ausnahme SoapHeaderAttribute ausgelöst wird, wenden Sie einen SoapHeaderAttribute.Direction auf die FaultMethode an, und legen Sie die-Eigenschaft auf fest.To specify that an XML Web service method returns a SOAP header when an exception is thrown during its execution, apply a SoapHeaderAttribute to the method and set the SoapHeaderAttribute.Direction property to Fault.

Gilt für:

Siehe auch