SoapHeaderAttribute(String) Construtor

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)

Parâmetros

Exemplos

O seguinte MyWebService serviço Web XML define um SoapHeader do tipo MyHeader. O Hello método do serviço Web XML especifica o myHeader membro como propriedade MemberName para receber o conteúdo dos MyHeader cabeçalhos SOAP passados para o método do serviço Web 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

Observações

Um cliente de serviço Web XML ou serviço Web XML pode especificar os cabeçalhos SOAP que pretende processar para métodos específicos de serviço Web XML aplicando a SoapHeaderAttribute ao método de serviço Web XML na classe de serviço Web XML ou ao método correspondente na classe proxy. Para que o método do serviço Web XML receba o conteúdo do cabeçalho SOAP, um membro é adicionado à classe de serviço Web XML de um Type derivado de SoapHeader. Da mesma forma, um cliente de serviço Web XML adiciona um membro à classe proxy derivada de SoapHeader. Esse Type que deriva de SoapHeader representa o conteúdo do cabeçalho SOAP e é criado pelo programador do serviço Web XML ou cliente de serviço Web XML que pretende receber o cabeçalho SOAP. Uma vez criada a classe, pode ser aplicado ao SoapHeaderAttribute método do serviço Web XML ou ao método correspondente na classe proxy do cliente do serviço Web XML, especificando o membro a receber o conteúdo do cabeçalho SOAP com o memberName parâmetro deste construtor ou da MemberName propriedade.

Um método de serviço Web XML pode receber múltiplos cabeçalhos SOAP ao adicionar múltiplos membros à classe de serviço Web XML ou à classe proxy de serviço Web XML e, por sua vez, aplicar múltiplos SoapHeaderAttribute atributos ao método de serviço Web XML.

Para receber e processar cabeçalhos SOAP desconhecidos no momento em que o serviço Web XML é escrito, especifique que o Type do membro seja ou SoapUnknownHeader, SoapHeader ou um array de qualquer uma das classes.