SoapUnknownHeader Clase

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Representa los datos recibidos de un encabezado SOAP que el servicio Web XML o el cliente de servicios Web XML de destino no reconocen. Esta clase no puede heredarse.

public ref class SoapUnknownHeader sealed : System::Web::Services::Protocols::SoapHeader

public sealed class SoapUnknownHeader : System.Web.Services.Protocols.SoapHeader

type SoapUnknownHeader = class
    inherit SoapHeader

Public NotInheritable Class SoapUnknownHeader
Inherits SoapHeader

Herencia

Object

SoapHeader

SoapUnknownHeader

Ejemplos

El MyWebService servicio web XML acepta y procesa el MyHeader encabezado SOAP enviado con cualquier llamada al método de MyWebMethod servicio web XML. Además, MyWebMethod recibe los encabezados SOAP que no sean el MyHeader encabezado SOAP.

<%@ WebService Language="C#" Class="MyWebService"%>
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System;

// Define a SOAP header by deriving from the SoapHeader base class.

public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;
    // Receive all SOAP headers besides the MyHeader SOAP header.
    public SoapUnknownHeader[] unknownHeaders;
 
    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]

    //Receive any SOAP headers other than MyHeader.
    [SoapHeader("unknownHeaders")]

    public string MyWebMethod() {

    string unknownHeaderAttributes = String.Empty;

        // Set myHeader.MyValue to some value.
         
       foreach (SoapUnknownHeader header in unknownHeaders) {
           // Perform some processing on the header.
           foreach (XmlAttribute attribute in header.Element.Attributes) {
              unknownHeaderAttributes = unknownHeaderAttributes + attribute.Name + ":" + attribute.Value + ";";            
           }
           // For those headers that cannot be 
           // processed, set the DidUnderstand property to false.
           header.DidUnderstand = false;
       }
       return unknownHeaderAttributes;
    }
}

<%@ WebService Language="VB" Class="MyWebService"%>
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml
Imports System

' Define a SOAP header by deriving from the SoapHeader base class.
Public Class MyHeader
    Inherits SoapHeader
    Public MyValue As String
End Class

Public Class MyWebService
    
    Public myHeader As MyHeader
    
    ' Receive all SOAP headers besides the MyHeader SOAP header.
    Public unknownHeaders() As SoapUnknownHeader    

    'Receive any SOAP headers other than MyHeader.
    <WebMethod, _
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut), _
    SoapHeader("unknownHeaders")> _
    Public Function MyWebMethod() As String
        Dim unknownHeaderAttributes As String = String.Empty
        
        ' Set myHeader.MyValue to some value.
        Dim header As SoapUnknownHeader
        For Each header In  unknownHeaders
            ' Perform some processing on the header.
            Dim attribute As XmlAttribute
            For Each attribute In header.Element.Attributes
                unknownHeaderAttributes &= attribute.Name & ":" & _
                    attribute.Value & ";"
            Next attribute
            ' For those headers that cannot be 
            ' processed, set the DidUnderstand property to false.
            header.DidUnderstand = False
        Next header
        
        Return unknownHeaderAttributes
        
    End Function
End Class

Comentarios

Un cliente SOAP podría invocar un servicio web XML con datos adicionales más allá de los parámetros necesarios en forma de encabezado SOAP. Un servicio web XML creado con ASP.NET o un cliente de servicio web XML puede ver los encabezados SOAP que no sabía en el momento en que se escribió el servicio web XML aplicando un SoapHeaderAttribute con una MemberName propiedad de una matriz de SoapHeader, SoapUnknownHeader SoapHeadero una matriz de SoapUnknownHeader al método de servicio web XML. Especificar un Type de SoapUnknownHeader, permite que el servicio web XML vea el contenido del encabezado SOAP en forma de .XmlElement

Constructores

SoapUnknownHeader()

Inicializa una nueva instancia de la clase SoapUnknownHeader.

Propiedades

Actor	Obtiene o establece el destinatario del encabezado SOAP. (Heredado de SoapHeader)
DidUnderstand	Obtiene o establece un valor que indica si un método de servicios Web XML procesó correctamente un encabezado SOAP. (Heredado de SoapHeader)
Element	Obtiene o establece el elemento de encabezado XML de la solicitud o respuesta SOAP.
EncodedMustUnderstand	Obtiene o establece el valor del atributo XML mustUnderstand para el encabezado SOAP al comunicarse con la versión 1.1 del protocolo SOAP. (Heredado de SoapHeader)
EncodedMustUnderstand12	Obtiene o establece el valor del atributo XML mustUnderstand para el encabezado SOAP al comunicarse con la versión 1.2 del protocolo SOAP. (Heredado de SoapHeader)
EncodedRelay	Obtiene o establece el atributo de retransmisión del encabezado SOAP 1.2. (Heredado de SoapHeader)
MustUnderstand	Obtiene o establece un valor que indica si debe reconocerse SoapHeader. (Heredado de SoapHeader)
Relay	Obtiene o establece un valor que indica si el encabezado SOAP se retransmite al siguiente nodo SOAP si el nodo actual no entiende el encabezado. (Heredado de SoapHeader)
Role	Obtiene o establece el destinatario del encabezado SOAP. (Heredado de SoapHeader)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• SoapHeaderAttribute
• SoapHeader