SoapHeaderAttribute(String) Konstruktor

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Inicializuje novou instanci SoapHeaderAttribute třídy a nastaví člen třídy webové služby XML představující obsah hlavičky SOAP.

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)

Parametry

memberName

String

Člen třídy webové služby XML představující obsah hlavičky SOAP. Vlastnost MemberName bude nastavena na hodnotu tohoto parametru.

Příklady

Následující MyWebService webová služba XML definuje jednu SoapHeader z typů MyHeader. Metoda Hello webové služby XML určuje myHeader člen jako MemberName vlastnost pro příjem obsahu MyHeader hlaviček SOAP předaných do metody webové služby XML.

#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

Poznámky

Klient webové služby XML nebo webová služba XML může určit hlavičky SOAP, které chce zpracovat pro konkrétní metody webové služby XML použitím SoapHeaderAttribute metody webové služby XML ve třídě webové služby XML nebo odpovídající metodu ve třídě proxy. Aby metoda webové služby XML přijímala obsah hlavičky SOAP, přidá se člen do třídy Type webové služby XML odvozené z SoapHeader. Podobně klient webové služby XML přidá člena do třídy proxy odvozený z SoapHeader. Ten Type odvozený z SoapHeader představuje obsah hlavičky SOAP a je vytvořen vývojářem webové služby XML nebo klienta webové služby XML, který chce přijmout hlavičku SOAP. Po vytvoření SoapHeaderAttribute třídy lze použít metodu webové služby XML nebo odpovídající metodu ve třídě proxy klienta webové služby XML určující člen pro příjem obsahu hlavičky SOAP s parametrem memberName pro tento konstruktor nebo MemberName vlastnost.

Metoda webové služby XML může přijímat více hlaviček SOAP přidáním více členů do třídy webové služby XML nebo třídy proxy webové služby XML a následně použití více SoapHeaderAttribute atributů na metodu webové služby XML.

Chcete-li přijímat a zpracovávat neznámé hlavičky SOAP v době, kdy je zapsána webová služba XML, zadejte Type člena SoapUnknownHeaderSoapHeader , nebo pole jedné třídy.