SoapHeaderAttribute(String) Konstruktor

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Initialisiert eine neue Instanz der SoapHeaderAttribute-Klasse, wobei der Member der XML-Webdienstklasse festgelegt wird, die den Inhalt des SOAP-Headers darstellt.

public:
 SoapHeaderAttribute(System::String ^ memberName);

public SoapHeaderAttribute (string memberName);

new System.Web.Services.Protocols.SoapHeaderAttribute : string -> System.Web.Services.Protocols.SoapHeaderAttribute

Public Sub New (memberName As String)

Parameter

memberName

String

Der Member der XML-Webdienstklasse, die den Inhalt des SOAP-Headers darstellt. Die MemberName-Eigenschaft wird auf den Wert dieses Parameters festgelegt.

Beispiele

Der folgende MyWebService XML-Webdienst definiert einen SoapHeader vom Typ MyHeader. Die Hello XML-Webdienstmethode gibt den myHeader Member als Eigenschaft an, um MemberName den Inhalt von MyHeader SOAP-Headern zu empfangen, die an die XML-Webdienstmethode übergeben werden.

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Web::Services;
using namespace System::Web::Services::Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public ref class MyHeader: public SoapHeader
{
public:
   String^ MyValue;
};

public ref class MyWebService
{
public:

   // Member variable to receive the contents of the MyHeader SOAP header.
   MyHeader^ myHeader;

   [WebMethod]
   [SoapHeader("myHeader",Direction=SoapHeaderDirection::InOut)]
   void Hello(){}

};

using System;
using System.Web.Services;
using System.Web.Services.Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {
    // Member variable to receive the contents of the MyHeader SOAP header.
    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]
    public void Hello() {
    }
}

Imports System.Web.Services
Imports System.Web.Services.Protocols

' Define a SOAP header by deriving from the SoapHeader base class.
' The header contains just one string value.
Public Class MyHeader
   Inherits SoapHeader
   Public MyValue As String
End Class


Public Class MyWebService
   ' Member variable to receive the contents of the MyHeader SOAP header.
   Public myHeader As MyHeader

   
   <WebMethod, _ 
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut)> _
   Public Sub Hello()

   End Sub
End Class

Hinweise

Ein XML-Webdienstclient oder XML-Webdienst kann die SOAP-Header angeben, die für bestimmte XML-Webdienstmethoden verarbeitet werden sollen, indem auf SoapHeaderAttribute die XML-Webdienstmethode in der XML-Webdienstklasse oder die entsprechende Methode in der Proxyklasse angewendet wird. Damit die XML-Webdienstmethode den Inhalt des SOAP-Headers empfängt, wird der XML-Webdienstklasse eines von SoapHeaderabgeleiteten Type -Elements ein Member hinzugefügt. Ebenso fügt ein XML-Webdienstclient der von SoapHeaderabgeleiteten Proxyklasse ein Element hinzu. Die Type von SoapHeader abgeleitete stellt den Inhalt des SOAP-Headers dar und wird vom Entwickler des XML-Webdiensts oder DES XML-Webdienstclients erstellt, der den SOAP-Header empfangen möchte. Nachdem die -Klasse erstellt wurde, kann auf SoapHeaderAttribute die XML-Webdienstmethode oder die entsprechende Methode in der Clientklasse des XML-Webdiensts angewendet werden, die den Member zum Empfangen des SOAP-Headerinhalts mit dem memberName Parameter für diesen Konstruktor oder die MemberName Eigenschaft angibt.

Eine XML-Webdienstmethode kann mehrere SOAP-Header empfangen, indem der XML-Webdienstklasse oder der XML-Webdienst-Proxyklasse mehrere Member hinzugefügt und wiederum mehrere SoapHeaderAttribute Attribute auf die XML-Webdienstmethode angewendet werden.

Um unbekannte SOAP-Header zum Zeitpunkt des Schreibens des XML-Webdiensts zu empfangen und zu verarbeiten, geben Sie den Type des Members als entweder SoapUnknownHeaderoder SoapHeader als Array einer klasse an.