SoapHeaderAttribute.MemberName Propriedade

Definição

Obtém ou define o membro da classe de serviço Web XML que representa o conteúdo do cabeçalho SOAP.Gets or sets the member of the XML Web service class representing the SOAP header contents.

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.The member of the XML Web service class representing the SOAP header contents. Não há nenhum padrão.There is no default.

Exemplos

O MyWebService Web Service XML a seguir define um SoapHeader do tipo MyHeader .The following MyWebService XML Web service defines one SoapHeader of type 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 XML Web Service.The Hello XML Web service method specifies the myHeader member as the MemberName property to receive the contents of MyHeader SOAP headers passed into the XML Web service method.

#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 Web Service 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.An XML Web service or XML Web service client can specify the SOAP headers it wants to process by applying a SoapHeaderAttribute to the XML Web service method in the XML Web service class or the corresponding method in the proxy class. Para que o método de serviço Web XML receba o conteúdo do cabeçalho SOAP, um membro é adicionado à classe XML Web Service de um tipo derivado de SoapHeader .In order for the XML Web service method to receive the contents of the SOAP header, a member is added to the XML Web service class of a type derived from SoapHeader. Da mesma forma, um cliente de serviço Web XML adiciona um membro à classe de proxy derivada de SoapHeader .Likewise, an XML Web service client adds a member to the proxy class deriving from SoapHeader. A Type derivação de SoapHeader representa o conteúdo do cabeçalho SOAP e é criada pelo desenvolvedor do serviço Web XML ou do cliente de Web Service XML que deseja receber o cabeçalho SOAP.The Type deriving from SoapHeader represents the contents of the SOAP header and is created by the developer of the XML Web service or XML Web service client that wants to receive the SOAP header. 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 de proxy do cliente de serviço Web XML que especifica o membro para receber o conteúdo do cabeçalho SOAP com a MemberName propriedade.Once the class is created, a SoapHeaderAttribute can be applied to the XML Web service method or corresponding method in the XML Web service client proxy class specifying the member to receive the SOAP header contents with the MemberName property.

Um método de serviço Web XML pode receber vários cabeçalhos SOAP adicionando vários membros à classe XML Web Service ou à classe proxy XML Web Service e, por sua vez, aplicando vários SoapHeaderAttribute atributos ao método XML Web Service.An XML Web service method can receive multiple SOAP headers by adding multiple members to the XML Web service class or the XML Web service proxy class and in turn applying multiple SoapHeaderAttribute attributes to the XML Web service method.

Para receber e processar cabeçalhos SOAP desconhecidos no momento em que o serviço Web XML é gravado, especifique o tipo do membro como SoapUnknownHeader SoapHeader ou uma matriz de uma das classes.To receive and process unknown SOAP headers at the time the XML Web service is written, specify the type of the member to be either SoapUnknownHeader, SoapHeader or an array of either class.

Aplica-se a