SoapHeaderAttribute.MemberName Propiedad

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Obtiene o establece el miembro de la clase de servicios Web XML que representa el contenido del encabezado 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 de propiedad

String

Miembro de la clase del servicio Web XML que representa el contenido del encabezado SOAP. No tiene ningún valor predeterminado.

Ejemplos

El siguiente MyWebService servicio web XML define uno SoapHeader de tipo MyHeader. El Hello método de servicio web XML especifica el myHeader miembro como propiedad MemberName para recibir el contenido de MyHeader los encabezados SOAP pasados al método de servicio 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

Comentarios

Un servicio web XML o un cliente de servicio web XML pueden especificar los encabezados SOAP que desea procesar aplicando un SoapHeaderAttribute al método de servicio web XML en la clase de servicio web XML o el método correspondiente de la clase de proxy. Para que el método de servicio web XML reciba el contenido del encabezado SOAP, se agrega un miembro a la clase de servicio web XML de un tipo derivado de SoapHeader. Del mismo modo, un cliente de servicio web XML agrega un miembro a la clase de proxy derivada de SoapHeader. El Type que deriva de SoapHeader representa el contenido del encabezado SOAP y lo crea el desarrollador del servicio web XML o el cliente del servicio web XML que quiere recibir el encabezado SOAP. Una vez creada la clase , SoapHeaderAttribute se puede aplicar al método de servicio web XML o al método correspondiente de la clase proxy de cliente del servicio web XML que especifica el miembro para recibir el contenido del encabezado SOAP con la MemberName propiedad .

Un método de servicio web XML puede recibir varios encabezados SOAP agregando varios miembros a la clase de servicio web XML o a la clase proxy de servicio web XML y, a su vez, aplicando varios SoapHeaderAttribute atributos al método de servicio web XML.

Para recibir y procesar encabezados SOAP desconocidos en el momento en que se escribe el servicio web XML, especifique el tipo del miembro que va a ser SoapUnknownHeadero SoapHeader una matriz de cualquiera de las clases.