SoapHeaderDirection Enumeration

Referenz

Definition

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt an, ob der Empfänger des SoapHeader der XML-Webdienst, der XML-Webdienstclient oder beides ist.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class SoapHeaderDirection

[System.Flags]
public enum SoapHeaderDirection

[<System.Flags>]
type SoapHeaderDirection =

Public Enum SoapHeaderDirection

Vererbung: Object

ValueType

Enum
SoapHeaderDirection

Attribute: FlagsAttribute

Felder

Name	Wert	Beschreibung
Fault	4	Gibt an, SoapHeader an den XML-Webdienstclient gesendet wird, wenn eine Ausnahme von der XML-Webdienstmethode ausgelöst wird.
In	1	Gibt an, SoapHeader an den XML-Webdienst gesendet wird.
InOut	3	Gibt an, SoapHeader sowohl an den XML-Webdienst als auch an den XML-Webdienstclient gesendet wird.
Out	2	Gibt an, SoapHeader an den XML-Webdienstclient gesendet wird.

Beispiele

Die folgende XML-Webdienstmethode gibt an, dass die myHeaderSoapHeader vom XML-Webdienstclient an den XML-Webdienstdienst gesendet wird, und dann zurück an den XML-Webdienstclient, unabhängig von einer Ausnahme, die während der Ausführung der XML-Webdienstmethode ausgelöst wird.

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-Webdienstmethode oder eine Methode einer Proxyklasse auf einen XML-Webdienst angewendet werden. In beiden Fällen werden die Empfänger durch die eigenschaft SoapHeaderAttribute.Direction angegeben. Um anzugeben, dass eine XML-Webdienstmethode einen SOAP-Header zurückgibt, wenn während der Ausführung eine Ausnahme ausgelöst wird, wenden Sie eine SoapHeaderAttribute auf die Methode an, und legen Sie die SoapHeaderAttribute.Direction-Eigenschaft auf Faultfest.

Gilt für:

Produkt	Versionen
.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

Freigeben über