Cómo: Controlador encabezados SOAP desconocidos

Artículo
10/07/2008

Un cliente de servicios web puede enviar una solicitud SOAP con un encabezado SOAP a un método de servicio web que el servicio web estaba esperando, pero no podría haber definido explícitamente. En este caso, es importante determinar si la semántica del encabezado SOAP se entiende y procesa, ya que la especificación SOAP indica que se iniciará una excepción cuando los encabezados SOAP tengan un atributo mustUnderstand establecido en true. Para obtener detalles sobre la administración de los encabezados SOAP requeridos por un cliente, consulte Controlar encabezados SOAP requeridos por un cliente del servicio web XML.

Para controlar los encabezados SOAP desconocidos de un cliente de servicios web

Agregue una variable miembro a la clase que implementa el servicio web con un tipo de SoapUnknownHeader o SoapHeader o una matriz de uno de ellos para controlar varios encabezados SOAP desconocidos.

Al declarar el tipo como una matriz o una instancia única de SoapUnknownHeader, se tiene la ventaja adicional que SoapUnknownHeader tiene una propiedad Element. La propiedad Element es de tipo XmlElement y representa el documento XML para el elemento Header de la solicitud o la respuesta SOAP. Así, un método de servicio web puede determinar el nombre del encabezado SOAP, junto con los datos pasados por el encabezado SOAP, consultando la propiedad Element.
```
public class MyWebService {
    public SoapUnknownHeader[] unknownHeaders;
```
```
Public Class MyWebService
    Public unknownHeaders() As SoapUnknownHeader
```

Aplique un atributo SoapHeader a cada método de servicio web que esté pensado para procesar cada encabezado SOAP desconocido.


    [WebMethod]
    [SoapHeader("unknownHeaders")]
    public string MyWebMethod()

    <WebMethod, _
     SoapHeader("unknownHeaders") > _
    Public Function MyWebMethod() As String

Agregue código para determinar si puede procesar cualquier encabezado SOAP desconocido.

Si la variable miembro es de tipo SoapUnknownHeader, un método de servicio web puede determinar el nombre del encabezado SOAP, junto con los datos pasados por el encabezado SOAP, consultando la propiedad Element. La propiedad Name de la propiedad Element identifica el nombre del encabezado SOAP.


       foreach (SoapUnknownHeader header in unknownHeaders) 
       {
         // Check to see if this a known header.
         if (header.Element.Name == "MyKnownHeader")

       Dim header As SoapUnknownHeader       
       For Each header In unknownHeaders
         ' Check to see if this is a known header.
         If (header.Element.Name = "MyKnownHeader") Then

Establezca la propiedad DidUnderstand de la variable miembro que representa el encabezado SOAP desconocido en true si se sabe cómo procesar un encabezado SOAP determinado.

Si un método de servicio web procesa un encabezado SOAP desconocido y no establece la propiedad DidUnderstand en true, se puede iniciar SoapHeaderException. Para obtener más detalles, consulte Controlar encabezados SOAP requeridos por un cliente del servicio web XML

         // Check to see if this is a known header.
         if (header.Element.Name == "MyKnownHeader")
               header.DidUnderstand = true;
         else
             // For those headers that cannot be 
             // processed, set DidUnderstand to false.
             header.DidUnderstand = false;
         }

         ' Check to see if this a known header.
         If (header.Element.Name = "MyKnownHeader") Then
               header.DidUnderstand = True
         Else
             ' For those headers that cannot be 
             ' processed, set DidUnderstand to false.
             header.DidUnderstand = False
         End If

Nota:
Los servicios web creados usando ASP.NET utilizan la propiedad DidUnderstand para comunicarse con el método de servicio web. Esto no forma parte de la especificación SOAP. Su valor no aparece en cualquier parte de la solicitud o respuesta SOAP.

Nota:
Cuando un cliente de servicios web genera una clase de proxy mediante la herramienta Lenguaje de descripción de servicios web (Wsdl.exe) y un servicio web define la variable miembro que representa un encabezado SOAP con el tipo SoapUnknownHeader, no se agrega ninguna referencia a ese encabezado SOAP a la clase de proxy. Si un cliente de servicios web decide agregar ese encabezado SOAP a la solicitud SOAP, debe modificar la clase de proxy agregando una variable miembro y aplicando un atributo SoapHeader al método que realiza la llamada al método de servicio web aplicable.

Cuando un cliente de servicios web genera una clase de proxy mediante la herramienta Lenguaje de descripción de servicios web (Wsdl.exe) y un servicio web define la variable miembro que representa un encabezado SOAP con el tipo SoapUnknownHeader, no se agrega ninguna referencia a ese encabezado SOAP a la clase de proxy. Si un cliente de servicios web decide agregar ese encabezado SOAP a la solicitud SOAP, debe modificar la clase de proxy agregando una variable miembro y aplicando un atributo SoapHeader al método que realiza la llamada al método de servicio web aplicable.

Consulte también

Compartir a través de

Cómo: Controlador encabezados SOAP desconocidos

Para controlar los encabezados SOAP desconocidos de un cliente de servicios web

Consulte también

Referencia

Conceptos

Otros recursos

Recursos adicionales