SoapHeaderAttribute.MemberName Propriedade

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtém ou define o membro da classe de serviço Web XML que representa o conteúdo do cabeçalho SOAP.

public:
 property System::String ^ MemberName { System::String ^ get(); void set(System::String ^ value); };

public string MemberName { get; set; }

member this.MemberName : string with get, set

Public Property MemberName As String

Valor da propriedade

String

O membro da classe de serviço Web XML que representa o conteúdo do cabeçalho SOAP. Não há nenhum padrão.

Exemplos

O serviço Web XML a seguir MyWebService define um SoapHeader do 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 serviço Web XML ou um cliente de serviço Web XML pode especificar os cabeçalhos SOAP que deseja processar aplicando um SoapHeaderAttribute ao 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 tipo derivado de SoapHeader. Da mesma forma, um cliente de serviço Web XML adiciona um membro à classe proxy derivada de SoapHeader. O Type derivado de 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, um SoapHeaderAttribute pode ser aplicado ao método de serviço Web XML ou ao método correspondente na classe proxy do cliente do serviço Web XML especificando o membro para receber o conteúdo do cabeçalho SOAP com 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 de 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 tipo do membro a ser SoapUnknownHeaderou SoapHeader uma matriz de qualquer classe.