SoapHeaderAttribute(String) Konstruktor

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)

Parametrar

Exempel

Följande MyWebService XML-webbtjänst definierar en SoapHeader av typen MyHeader. XML-webbtjänstmetoden Hello anger myHeader medlemmen som egenskapen MemberName för att ta emot innehållet i MyHeader SOAP-huvuden som skickas till XML-webbtjänstmetoden.

#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

Kommentarer

En XML-webbtjänstklient eller XML-webbtjänst kan ange de SOAP-huvuden som den vill bearbeta för specifika XML-webbtjänstmetoder genom att tillämpa en SoapHeaderAttribute på XML-webbtjänstmetoden i XML-webbtjänstklassen eller motsvarande metod i proxyklassen. För att XML-webbtjänstmetoden ska kunna ta emot innehållet i SOAP-huvudet läggs en medlem till i XML-webbtjänstklassen för en Type härledd från SoapHeader. På samma sätt lägger en XML-webbtjänstklient till en medlem i proxyklassen som härleds från SoapHeader. Det som Type härleds från SoapHeader representerar innehållet i SOAP-huvudet och skapas av utvecklaren av XML-webbtjänsten eller XML-webbtjänstklienten som vill ta emot SOAP-huvudet. När klassen har skapats kan en SoapHeaderAttribute tillämpas på XML-webbtjänstmetoden eller motsvarande metod i XML-webbtjänstklientproxyklassen som anger medlemmen för att ta emot SOAP-huvudets innehåll med parametern memberName till den här konstruktorn eller MemberName egenskapen.

En XML-webbtjänstmetod kan ta emot flera SOAP-huvuden genom att lägga till flera medlemmar i XML-webbtjänstklassen eller XML-webbtjänstproxyklassen och i sin tur tillämpa flera SoapHeaderAttribute attribut på XML-webbtjänstmetoden.

Om du vill ta emot och bearbeta okända SOAP-huvuden när XML-webbtjänsten skrivs anger du Type för medlemmen som antingen SoapUnknownHeadereller SoapHeader en matris med någon av klasserna.