SoapHeaderAttribute(String) Constructor

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)

Parameters

Voorbeelden

De volgende MyWebService XML-webservice definieert een SoapHeader van het type MyHeader. De Hello XML-webservicemethode geeft het myHeader lid op als de MemberName eigenschap voor het ontvangen van de inhoud van MyHeader SOAP-headers die zijn doorgegeven aan de XML-webservicemethode.

#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

Opmerkingen

Een XML-webserviceclient of XML-webservice kan de SOAP-headers opgeven die voor specifieke XML-webservicemethoden moeten worden verwerkt door een toe SoapHeaderAttribute te passen op de XML-webservicemethode in de XML-webserviceklasse of de bijbehorende methode in de proxyklasse. Om de XML-webservicemethode de inhoud van de SOAP-header te kunnen ontvangen, wordt een lid toegevoegd aan de XML-webserviceklasse van een Type afgeleid van SoapHeader. Op dezelfde manier voegt een XML-webserviceclient een lid toe aan de proxyklasse die is afgeleid van SoapHeader. Die Type afgeleid is van SoapHeader de inhoud van de SOAP-header en wordt gemaakt door de ontwikkelaar van de XML-webservice- of XML-webserviceclient die de SOAP-header wil ontvangen. Zodra de klasse is gemaakt, kan een SoapHeaderAttribute worden toegepast op de XML-webservicemethode of de bijbehorende methode in de proxyklasse van de XML-webserviceclient die het lid opgeeft voor het ontvangen van de SOAP-headerinhoud met de memberName parameter voor deze constructor of de MemberName eigenschap.

Een XML-webservicemethode kan meerdere SOAP-headers ontvangen door meerdere leden toe te voegen aan de XML-webserviceklasse of de xml-webserviceproxyklasse en vervolgens meerdere SoapHeaderAttribute kenmerken toe te passen op de XML-webservicemethode.

Als u onbekende SOAP-headers wilt ontvangen en verwerken op het moment dat de XML-webservice wordt geschreven, geeft u het Type lid op dat moet worden SoapUnknownHeaderopgegeven of SoapHeader een matrix van een van beide klassen.