SoapHeaderDirection-Enumeration

Artikel
08/20/2007

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.

Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration SoapHeaderDirection
'Usage
Dim instance As SoapHeaderDirection

[FlagsAttribute] 
public enum SoapHeaderDirection

[FlagsAttribute] 
public enum class SoapHeaderDirection

/** @attribute FlagsAttribute() */ 
public enum SoapHeaderDirection

FlagsAttribute 
public enum SoapHeaderDirection

Member

	Membername	Beschreibung
	Fault	Legt fest, dass der SoapHeader beim Auslösen einer Ausnahme durch die XML-Webdienstmethode an den XML-Webdienstclient gesendet wird.
	In	Gibt an, dass SoapHeader an den XML-Webdienst gesendet wird.
	InOut	Gibt an, dass SoapHeader an den XML-Webdienst und den XML-Webdienstclient gesendet wird.
	Out	Gibt an, dass SoapHeader an den XML-Webdienstclient gesendet wird.

Hinweise

Ein SoapHeaderAttribute kann auf eine XML-Webdienstmethode oder eine Methode einer Proxyklasse eines XML-Webdiensts angewendet werden. In beiden Fällen wird der/werden die Empfänger durch die Direction-Eigenschaft von SoapHeaderAttribute angegeben. Wenn Sie festlegen möchten, dass eine XML-Webdienstmethode einen SOAP-Header zurückgibt, wenn bei dessen Ausführung eine Ausnahme ausgelöst wird, wenden Sie ein SoapHeaderAttribute auf die Methode an, und legen Sie die Direction-Eigenschaft auf Fault fest.

Version 1.0 von .NET Framework unterstützt den Fault-Wert nicht.

Beispiel

Die folgende XML-Webdienstmethode gibt an, dass der myHeaderSoapHeader, unabhängig von einer während der Ausführung der XML-Webdienstmethode ausgelösten Ausnahme, vom XML-Webdienstclient an den XML-Webdienst und anschließend zurück an den XML-Webdienstclient gesendet wird.

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

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 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 extends SoapHeader
{
    public String myValue;
} //MyHeader

public class MyWebService
{
    public MyHeader myHeader;

    /** @attribute WebMethod()
     */
    /** @attribute SoapHeader("myHeader", Direction = 
         SoapHeaderDirection.InOut | SoapHeaderDirection.Fault)
     */

    public void MySoapHeaderReceivingMethod()
    {
        // Set myHeader.myValue to some value.
    } //MySoapHeaderReceivingMethod
} //MyWebService

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

System.Web.Services.Protocols-Namespace
SoapHeaderAttribute-Klasse
SoapHeader-Klasse

Freigeben über