SoapUnknownHeader Classe

Definizione

Rappresenta i dati ricevuti da un'intestazione SOAP che non è stata riconosciuta dal client di servizi Web XML o dal servizio Web XML di destinazione.Represents the data received from a SOAP header that was not understood by the recipient XML Web service or XML Web service client. Questa classe non può essere ereditata.This class cannot be inherited.

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à
SoapUnknownHeader

Esempi

Il MyWebService servizio Web XML accetta ed elabora l' MyHeader intestazione SOAP inviata con qualsiasi chiamata al metodo MyWebMethod del servizio Web XML.The MyWebService XML Web service accepts and processes the MyHeader SOAP header sent with any calls to the MyWebMethod XML Web service method. Inoltre, MyWebMethod riceve tutte le intestazioni SOAP diverse dall' MyHeader intestazione SOAP.Additionally, MyWebMethod receives any SOAP headers other than the MyHeader SOAP header.

<%@ 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 può richiamare un servizio Web XML con dati aggiuntivi oltre i parametri richiesti sotto forma di intestazione SOAP.A SOAP client might invoke an XML Web service with additional data beyond the required parameters in the form of a SOAP header. Un servizio Web XML creato utilizzando ASP.NET o un client del servizio Web XML può visualizzare le intestazioni SOAP non note al momento della scrittura del servizio Web XML applicando un oggetto SoapHeaderAttribute con una MemberName proprietà di una matrice di SoapHeader, SoapHeadero una matrice di SoapUnknownHeader al metodo del servizio Web XML. SoapUnknownHeaderAn XML Web service created using ASP.NET or an XML Web service client can view any SOAP headers it did not know about at the time the XML Web service was written by applying a SoapHeaderAttribute with a MemberName property of either an array of SoapHeader, SoapHeader, SoapUnknownHeader or an array of SoapUnknownHeader to the XML Web service method. Se si Type specifica SoapUnknownHeaderun oggetto di, il servizio Web XML può visualizzare il contenuto dell'intestazione SOAP sotto forma di un XmlElementoggetto.Specifying a Type of SoapUnknownHeader, allows the XML Web service to view the contents of the SOAP header in the form of an XmlElement.

Costruttori

SoapUnknownHeader()

Inizializza una nuova istanza della classe SoapUnknownHeader.Initializes a new instance of the SoapUnknownHeader class.

Proprietà

Actor

Ottiene o imposta il destinatario dell'intestazione SOAP.Gets or sets the recipient of the SOAP header.

(Ereditato da SoapHeader)
DidUnderstand

Ottiene o imposta un valore che indica se un metodo di servizio Web XML ha elaborato correttamente un'intestazione SOAP.Gets or sets a value indicating whether an XML Web service method properly processed a SOAP header.

(Ereditato da SoapHeader)
Element

Ottiene o imposta l'elemento Intestazione XML per una richiesta o una risposta SOAP.Gets or sets the XML Header element for a SOAP request or response.

EncodedMustUnderstand

Ottiene o imposta il valore dell'attributo XML mustUnderstand per l'intestazione SOAP quando in comunicazione con il protocollo SOAP 1.1.Gets or sets the value of the mustUnderstand XML attribute for the SOAP header when communicating with SOAP protocol version 1.1.

(Ereditato da SoapHeader)
EncodedMustUnderstand12

Ottiene o imposta il valore dell'attributo XML mustUnderstand per l'intestazione SOAP durante la comunicazione con il protocollo SOAP 1.2.Gets or sets the value of the mustUnderstand XML attribute for the SOAP header when communicating with SOAP protocol version 1.2.

(Ereditato da SoapHeader)
EncodedRelay

Ottiene o imposta l'attributo "relay" dell'intestazione SOAP 1.2.Gets or sets the relay attribute of the SOAP 1.2 header.

(Ereditato da SoapHeader)
MustUnderstand

Ottiene o imposta un valore che indica se l'oggetto SoapHeader deve essere riconosciuto.Gets or sets a value indicating whether the SoapHeader must be understood.

(Ereditato da SoapHeader)
Relay

Ottiene o imposta un valore che indica se l'intestazione SOAP deve essere inoltrata al successivo nodo SOAP se il nodo corrente non riconosce l'intestazione.Gets or sets a value that indicates whether the SOAP header is to be relayed to the next SOAP node if the current node does not understand the header.

(Ereditato da SoapHeader)
Role

Ottiene o imposta il destinatario dell'intestazione SOAP.Gets or sets the recipient of the SOAP header.

(Ereditato da SoapHeader)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche