SoapUnknownHeader Classe

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Rappresenta i dati ricevuti da un'intestazione SOAP non compresa dal client del servizio Web XML o del servizio Web XML del destinatario. Questa classe non può essere ereditata.

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

Ereditarietà

Object

SoapHeader

SoapUnknownHeader

Esempio

Il MyWebService servizio Web XML accetta ed elabora l'intestazione MyHeader SOAP inviata con qualsiasi chiamata al metodo del MyWebMethod servizio Web XML. Riceve inoltre MyWebMethod eventuali intestazioni SOAP diverse dall'intestazione MyHeader 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

Commenti

Un client SOAP potrebbe richiamare un servizio Web XML con dati aggiuntivi oltre i parametri obbligatori sotto forma di intestazione SOAP. Un servizio Web XML creato utilizzando ASP.NET o un client del servizio Web XML può visualizzare eventuali intestazioni SOAP che non sapevano al momento della scrittura del servizio Web XML applicando un SoapHeaderAttribute oggetto con una MemberName proprietà di una matrice di SoapHeader, SoapHeaderSoapUnknownHeader o una matrice di SoapUnknownHeader al metodo del servizio Web XML. La specifica Type di SoapUnknownHeaderconsente al servizio Web XML di visualizzare il contenuto dell'intestazione SOAP sotto forma di .XmlElement

Costruttori

Nome	Descrizione
SoapUnknownHeader()	Inizializza una nuova istanza della classe SoapUnknownHeader.

Proprietà

Nome	Descrizione
Actor	Ottiene o imposta il destinatario dell'intestazione SOAP. (Ereditato da SoapHeader)
DidUnderstand	Ottiene o imposta un valore che indica se un metodo di servizio Web XML ha elaborato correttamente un'intestazione SOAP. (Ereditato da SoapHeader)
Element	Ottiene o imposta l'elemento Header XML per una richiesta o una risposta SOAP.
EncodedMustUnderstand	Ottiene o imposta il valore dell'attributo XML per l'intestazione mustUnderstand SOAP durante la comunicazione con il protocollo SOAP versione 1.1. (Ereditato da SoapHeader)
EncodedMustUnderstand12	Ottiene o imposta il valore dell'attributo XML per l'intestazione mustUnderstand SOAP durante la comunicazione con il protocollo SOAP versione 1.2. (Ereditato da SoapHeader)
EncodedRelay	Ottiene o imposta l'attributo di inoltro dell'intestazione SOAP 1.2. (Ereditato da SoapHeader)
MustUnderstand	Ottiene o imposta un valore che indica se deve SoapHeader essere compreso. (Ereditato da SoapHeader)
Relay	Ottiene o imposta un valore che indica se l'intestazione SOAP deve essere inoltrata al nodo SOAP successivo se il nodo corrente non riconosce l'intestazione. (Ereditato da SoapHeader)
Role	Ottiene o imposta il destinatario dell'intestazione SOAP. (Ereditato da SoapHeader)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• SoapHeaderAttribute
• SoapHeader