SoapUnknownHeader Klasse

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Stellt die von einem SOAP-Header empfangenen Daten dar, die vom empfangenden XML-Webdienst oder XML-Webdienstclient nicht erkannt wurden. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

SoapHeader

SoapUnknownHeader

Beispiele

Der MyWebService XML-Webdienst akzeptiert und verarbeitet den SOAP-Header, der MyHeader mit allen Aufrufen der MyWebMethod XML-Webdienstmethode gesendet wird. Empfängt MyWebMethod darüber hinaus alle ANDEREN SOAP-Header als den 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

Hinweise

Ein SOAP-Client kann einen XML-Webdienst mit zusätzlichen Daten aufrufen, die über die erforderlichen Parameter in Form eines SOAP-Headers hinausgehen. Ein mithilfe von ASP.NET oder einem XML-Webdienstclient erstellte XML-Webdienst kann alle SOAP-Header anzeigen, über die er zum Zeitpunkt der Erstellung des XML-Webdiensts nicht informiert wurde, indem eine SoapHeaderAttribute MemberName Eigenschaft eines Arrays von , SoapUnknownHeader SoapHeaderoder ein Array SoapHeaderder SoapUnknownHeader XML-Webdienstmethode angewendet wird. Das Angeben eines Type von SoapUnknownHeader, ermöglicht dem XML-Webdienst das Anzeigen des Inhalts des SOAP-Headers in Form einer XmlElement.

Konstruktoren

SoapUnknownHeader()

Initialisiert eine neue Instanz der SoapUnknownHeader-Klasse.

Eigenschaften

Actor	Ruft den Empfänger des SOAP-Headers ab oder legt diesen fest. (Geerbt von SoapHeader)
DidUnderstand	Ruft einen Wert ab, der angibt, ob eine XML-Webdienstmethode einen SOAP-Header richtig verarbeitet hat, oder legt diesen Wert fest. (Geerbt von SoapHeader)
Element	Ruft das XML-Headerelement für eine SOAP-Anforderung oder -Antwort ab oder legt dieses fest.
EncodedMustUnderstand	Ruft bei der Kommunikation mit dem SOAP-Protokoll, Version 1.1, den Wert des mustUnderstand-XML-Attributs für den SOAP-Header ab oder legt diesen fest. (Geerbt von SoapHeader)
EncodedMustUnderstand12	Ruft bei der Kommunikation mit dem SOAP-Protokoll, Version 1.2, den Wert des mustUnderstand-XML-Attributs für den SOAP-Header ab oder legt diesen fest. (Geerbt von SoapHeader)
EncodedRelay	Ruft das relay-Attribut des SOAP 1.2-Headers ab oder legt dieses fest. (Geerbt von SoapHeader)
MustUnderstand	Ruft einen Wert ab, der angibt, ob der SoapHeader verstanden werden muss, oder legt diesen fest. (Geerbt von SoapHeader)
Relay	Ruft einen Wert ab, der angibt, ob der SOAP-Header an den nächsten SOAP-Knoten weitergeleitet werden soll, wenn der aktuelle Knoten den Header nicht versteht. (Geerbt von SoapHeader)
Role	Ruft den Empfänger des SOAP-Headers ab oder legt diesen fest. (Geerbt von SoapHeader)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Siehe auch

• SoapHeaderAttribute
• SoapHeader