SoapUnknownHeader Osztály

Definíció

Névtér:

System.Web.Services.Protocols

Szerelvény:

System.Web.Services.dll

A SOAP-fejlécből kapott adatokat jelöli, amelyeket a címzett XML-webszolgáltatás vagy az XML-webszolgáltatás-ügyfél nem értett meg. Ez az osztály nem örökölhető.

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

Öröklődés

Object

SoapHeader

SoapUnknownHeader

Példák

Az MyWebService XML-webszolgáltatás elfogadja és feldolgozza a MyHeader SOAP fejlécet, amelyet az MyWebMethod XML Web Service metódusnak küldött bármilyen hívással küld. Emellett MyWebMethod a SOAP fejlécen kívül MyHeader minden SOAP-fejlécet is megkap.

<%@ 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

Megjegyzések

A SOAP-ügyfél meghívhat egy XML-webszolgáltatást, amely a szükséges paramétereken túl további adatokat is tartalmazhat SOAP-fejléc formájában. A ASP.NET vagy xml webszolgáltatás-ügyfél használatával létrehozott XML-webszolgáltatás megtekintheti azokat a SOAP-fejléceket, amelyekről az XML-webszolgáltatás írásakor nem tudott, és egy SoapHeaderAttribute tömb MemberName tulajdonságával rendelkező SoapHeader alkalmaz, SoapHeader, SoapUnknownHeader vagy SoapUnknownHeader tömbje az XML Web Service metódushoz. Az egyik TypeSoapUnknownHeadermegadása lehetővé teszi, hogy az XML-webszolgáltatás a SOAP fejléc tartalmát egy XmlElement.

Konstruktorok

Name	Description
SoapUnknownHeader()	Inicializálja a SoapUnknownHeader osztály új példányát.

Tulajdonságok

Name	Description
Actor	Lekéri vagy beállítja a SOAP fejléc címzettjének nevét. (Öröklődés forrása SoapHeader)
DidUnderstand	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy XML-webszolgáltatás-metódus megfelelően feldolgozott-e SOAP-fejlécet. (Öröklődés forrása SoapHeader)
Element	Lekéri vagy beállítja az XML-fejléc elemet egy SOAP-kéréshez vagy válaszhoz.
EncodedMustUnderstand	A SOAP-protokoll 1.1-es verziójával folytatott kommunikáció során lekéri vagy beállítja a SOAP-fejléc XML-attribútumának értékét mustUnderstand . (Öröklődés forrása SoapHeader)
EncodedMustUnderstand12	Lekéri vagy beállítja a mustUnderstand SOAP-fejléc XML-attribútumának értékét a SOAP protokoll 1.2-es verziójával való kommunikáció során. (Öröklődés forrása SoapHeader)
EncodedRelay	Lekéri vagy beállítja a SOAP 1.2 fejléc relay attribútumát. (Öröklődés forrása SoapHeader)
MustUnderstand	Lekéri vagy beállít egy értéket, amely jelzi, hogy az SoapHeader értéket meg kell-e érteni. (Öröklődés forrása SoapHeader)
Relay	Lekéri vagy beállít egy értéket, amely jelzi, hogy a SOAP-fejlécet a következő SOAP-csomópontra kell-e továbbítani, ha az aktuális csomópont nem érti a fejlécet. (Öröklődés forrása SoapHeader)
Role	Lekéri vagy beállítja a SOAP fejléc címzettjének nevét. (Öröklődés forrása SoapHeader)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• SoapHeaderAttribute
• SoapHeader