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-Webdienstmethode gibt an, dass die myHeader Fault wird aus der XML-Webdienstclient an die XML-Webdienst gesendet und dann zurück an die XML-Webdienstclient ungeachtet der eine Ausnahme ausgelöst wird, während der Ausführung des XML-Diensts -Methode.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

Hinweise

Ein SoapHeaderAttribute kann entweder eine XML-Webdienstmethode oder eine Methode einer Proxyklasse 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 angegeben, durch die Direction Eigenschaft SoapHeaderAttribute.In either case, the recipient(s) are specified by the Direction property of SoapHeaderAttribute. Um anzugeben, dass eine XML-Webdienstmethode einen SOAP-Header zurückgibt, wenn während der Ausführung eine Ausnahme ausgelöst wird, gelten eine SoapHeaderAttribute an die Methode, und legen die Direction Eigenschaft, um den Fehler.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.

Version 1.0 von .NET Framework unterstützt nicht den Wert des Fehlers.Version 1.0 of the .NET Framework does not support the Fault value.

Gilt für:

Siehe auch