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 jeden SoapHeader typ MyHeader. Metoda Hello webové služby XML určuje myHeader člena 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 zadat 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 byla metoda webové služby XML přijímat obsah hlavičky SOAP, člen je přidán do třídy webové služby XML odvozeného Type z SoapHeader. Podobně klient webové služby XML přidá člena do třídy proxy odvozené z SoapHeader. Tento 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 získat 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, který má přijmout obsah hlavičky SOAP s parametrem memberName tohoto konstruktoru MemberName nebo vlastnosti.

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 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ě zápisu webové služby XML, zadejte Type člen, který má být buď SoapUnknownHeader, SoapHeader nebo pole obou tříd.