SoapHeaderAttribute(String) Constructor

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Inicializa una nueva instancia de la clase SoapHeaderAttribute, estableciendo el miembro de la clase de servicios Web XML que representa el contenido del encabezado 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

Miembro de la clase del servicio Web XML que representa el contenido del encabezado SOAP. La propiedad MemberName se establecerá en el valor de este parámetro.

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 cliente de servicio web XML o un servicio web XML puede especificar los encabezados SOAP que desea procesar para métodos de servicio web XML específicos 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 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 Type derivado de SoapHeader. Del mismo modo, un cliente de servicio web XML agrega un miembro a la clase de proxy derivada de SoapHeader. Que Type 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 de proxy de cliente del servicio web XML que especifica el miembro para recibir el contenido del encabezado SOAP con el memberName parámetro a este constructor o a 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 Type del miembro que va a ser SoapUnknownHeadero SoapHeader una matriz de cualquiera de las clases.