SoapUnknownHeader.Element-Eigenschaft

Ruft das XML-Headerelement für eine SOAP-Anforderung oder -Antwort ab oder legt dieses fest.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property Element As XmlElement
'Usage
Dim instance As SoapUnknownHeader
Dim value As XmlElement

value = instance.Element

instance.Element = value

public XmlElement Element { get; set; }

public:
property XmlElement^ Element {
    XmlElement^ get ();
    void set (XmlElement^ value);
}

/** @property */
public XmlElement get_Element ()

/** @property */
public void set_Element (XmlElement value)

public function get Element () : XmlElement

public function set Element (value : XmlElement)

Eigenschaftenwert

Ein XmlElement, das die nicht formatierten XML-Rohdaten des SOAP-Headers darstellt.

Hinweise

Wenn eine XML-Webdienstmethode SOAP-Header verarbeiten soll, die beim Erstellen des XML-Webdiensts unbekannt waren, kann sie eine XmlElement-Klasse verarbeiten, die die nicht formatierten XML-Daten des SOAP-Headers darstellt.

Beispiel

Der folgende MyWebService-XML-Webdienst empfängt alle SOAP-Header, auch andere Header als den bekannten MyHeader-SOAP-Header. Die MyWebMethod-XML-Webdienstmethode gibt die XML-Attribute des letzten unbekannten SOAP-Headers, der ihr als Zeichenfolge übergeben wurde, an den Client zurück.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapUnknownHeader-Klasse
SoapUnknownHeader-Member
System.Web.Services.Protocols-Namespace
XmlElement
SoapHeaderAttribute-Klasse