SoapUnknownHeader Classe

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Représente les données reçues d’un en-tête SOAP qui n’a pas été compris par le service web XML du destinataire ou le client de service web XML. Cette classe ne peut pas être héritée.

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

Héritage

Object

SoapHeader

SoapUnknownHeader

Exemples

Le MyWebService service Web XML accepte et traite l’en-tête MyHeader SOAP envoyé avec tous les appels à la méthode de MyWebMethod service Web XML. En outre, MyWebMethod reçoit tous les en-têtes SOAP autres que l’en-tête 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

Remarques

Un client SOAP peut appeler un service Web XML avec des données supplémentaires au-delà des paramètres requis sous la forme d’un en-tête SOAP. Un service Web XML créé à l’aide de ASP.NET ou d’un client de service web XML peut afficher les en-têtes SOAP qu’il ne connaissait pas au moment où le service Web XML a été écrit en appliquant une SoapHeaderAttribute propriété d’un MemberName tableau de SoapHeader, SoapUnknownHeaderSoapHeaderou un tableau de SoapUnknownHeader la méthode de service Web XML. La spécification d’un TypeSoapUnknownHeader, permet au service Web XML d’afficher le contenu de l’en-tête SOAP sous la forme d’un XmlElement.

Constructeurs

Nom	Description
SoapUnknownHeader()	Initialise une nouvelle instance de la classe SoapUnknownHeader.

Propriétés

Nom	Description
Actor	Obtient ou définit le destinataire de l’en-tête SOAP. (Hérité de SoapHeader)
DidUnderstand	Obtient ou définit une valeur indiquant si une méthode de service Web XML a correctement traité un en-tête SOAP. (Hérité de SoapHeader)
Element	Obtient ou définit l’élément d’en-tête XML pour une requête ou une réponse SOAP.
EncodedMustUnderstand	Obtient ou définit la valeur de l’attribut mustUnderstand XML pour l’en-tête SOAP lors de la communication avec le protocole SOAP version 1.1. (Hérité de SoapHeader)
EncodedMustUnderstand12	Obtient ou définit la valeur de l’attribut mustUnderstand XML pour l’en-tête SOAP lors de la communication avec le protocole SOAP version 1.2. (Hérité de SoapHeader)
EncodedRelay	Obtient ou définit l’attribut de relais de l’en-tête SOAP 1.2. (Hérité de SoapHeader)
MustUnderstand	Obtient ou définit une valeur indiquant si la SoapHeader valeur doit être comprise. (Hérité de SoapHeader)
Relay	Obtient ou définit une valeur qui indique si l’en-tête SOAP doit être relayé au nœud SOAP suivant si le nœud actuel ne comprend pas l’en-tête. (Hérité de SoapHeader)
Role	Obtient ou définit le destinataire de l’en-tête SOAP. (Hérité de SoapHeader)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• SoapHeaderAttribute
• SoapHeader