SoapUnknownHeader Classe

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Representa os dados recebidos de um cabeçalho SOAP que não foi entendido pelo serviço Web XML destinatário ou pelo cliente do serviço Web XML. Essa classe não pode ser herdada.

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

Herança

Object

SoapHeader

SoapUnknownHeader

Exemplos

O MyWebService serviço Web XML aceita e processa o MyHeader cabeçalho SOAP enviado com todas as chamadas para o método de MyWebMethod serviço Web XML. Além disso, MyWebMethod recebe todos os cabeçalhos SOAP que não sejam o MyHeader cabeçalho 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

Comentários

Um cliente SOAP pode invocar um serviço Web XML com dados adicionais além dos parâmetros necessários na forma de um cabeçalho SOAP. Um serviço Web XML criado usando ASP.NET ou um cliente de serviço Web XML pode exibir quaisquer cabeçalhos SOAP que ele não conhecia no momento em que o serviço Web XML foi escrito aplicando um com uma SoapHeaderAttributeMemberName propriedade de uma matriz de SoapHeader, SoapHeaderou SoapUnknownHeader uma matriz de SoapUnknownHeader para o método de serviço Web XML. Especificar um Type de SoapUnknownHeader, permite que o serviço Web XML exiba o conteúdo do cabeçalho SOAP na forma de um XmlElement.

Construtores

SoapUnknownHeader()

Inicializa uma nova instância da classe SoapUnknownHeader.

Propriedades

Actor	Obtém ou define o destinatário do cabeçalho SOAP. (Herdado de SoapHeader)
DidUnderstand	Obtém ou define um valor que indica se um método de serviço Web XML processou corretamente um cabeçalho SOAP. (Herdado de SoapHeader)
Element	Obtém ou define o elemento de cabeçalho de XML para uma resposta ou solicitação SOAP.
EncodedMustUnderstand	Obtém ou define o valor do atributo XML mustUnderstand para o cabeçalho SOAP ao se comunicar com a versão do protocolo SOAP 1.1. (Herdado de SoapHeader)
EncodedMustUnderstand12	Obtém ou define o valor do atributo XML mustUnderstand para o cabeçalho SOAP ao se comunicar com a versão do protocolo SOAP 1.2. (Herdado de SoapHeader)
EncodedRelay	Obtém ou define o atributo de retransmissão do cabeçalho SOAP 1.2. (Herdado de SoapHeader)
MustUnderstand	Obtém ou define um valor que indica se o SoapHeader deve ser compreendido. (Herdado de SoapHeader)
Relay	Obtém ou define um valor que indica se o cabeçalho SOAP deverá ser retransmitido para o próximo nó SOAP se o nó atual não entender o cabeçalho. (Herdado de SoapHeader)
Role	Obtém ou define o destinatário do cabeçalho SOAP. (Herdado de SoapHeader)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• SoapHeaderAttribute
• SoapHeader