SoapHeaderAttribute(String) Construtor

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Inicializa uma nova instância da classe SoapHeaderAttribute, definindo o membro da classe de serviço Web XML que representa o conteúdo do cabeçalho 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)

Parâmetros

memberName

String

O membro da classe de serviço Web XML que representa o conteúdo do cabeçalho SOAP. A propriedade MemberName será definida como o valor desse parâmetro.

Exemplos

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

Comentários

Um cliente de serviço Web XML ou um serviço Web XML pode especificar os cabeçalhos SOAP que deseja processar para métodos de serviço Web XML específicos aplicando um SoapHeaderAttribute método de serviço Web XML na classe de serviço Web XML ou o método correspondente na classe proxy. Para que o método de 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.SoapHeader Da mesma forma, um cliente de serviço Web XML adiciona um membro à classe proxy derivada de SoapHeader. Esse Type derivado SoapHeader representa o conteúdo do cabeçalho SOAP e é criado pelo desenvolvedor do serviço Web XML ou do cliente de serviço Web XML que deseja receber o cabeçalho SOAP. Depois que a classe é criada, uma SoapHeaderAttribute pode ser aplicada ao método de serviço Web XML ou ao método correspondente na classe proxy do cliente de serviço Web XML especificando o membro para receber o conteúdo do cabeçalho SOAP com o memberName parâmetro para este construtor ou a MemberName propriedade.

Um método de serviço Web XML pode receber vários cabeçalhos SOAP adicionando vários membros à classe de serviço Web XML ou à classe proxy de serviço Web XML e, por sua vez, aplicando vários 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 é gravado, especifique o Type membro a ser SoapUnknownHeaderou SoapHeader uma matriz de qualquer classe.