SoapUnknownHeader Třída

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Představuje data přijatá z hlavičky SOAP, která nepochopena webovou službou XML příjemce nebo klientem webové služby XML. Tuto třídu nelze dědit.

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

Dědičnost

Object

SoapHeader

SoapUnknownHeader

Příklady

MyWebService Webová služba XML přijímá a zpracovává hlavičku MyHeader SOAP odeslanou všemi voláními MyWebMethod metody webové služby XML. Kromě toho MyWebMethod obdrží všechny hlavičky SOAP jiné než hlavičky 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

Poznámky

Klient SOAP může vyvolat webovou službu XML s dalšími daty nad rámec požadovaných parametrů ve formě hlavičky SOAP. Webová služba XML vytvořená pomocí ASP.NET nebo klienta webové služby XML může zobrazit jakékoli hlavičky SOAP, o kterých v době, kdy byla webová služba XML napsána pomocí SoapHeaderAttribute MemberName vlastnosti pole SoapHeadernebo SoapHeaderSoapUnknownHeader pole SoapUnknownHeader webové služby XML. Určení Type SoapUnknownHeaderhodnoty , umožňuje webové službě XML zobrazit obsah hlavičky SOAP ve formě XmlElement.

Konstruktory

SoapUnknownHeader()

Inicializuje novou instanci SoapUnknownHeader třídy.

Vlastnosti

Actor	Získá nebo nastaví příjemce hlavičky SOAP. (Zděděno od SoapHeader)
DidUnderstand	Získá nebo nastaví hodnotu určující, zda metoda webové služby XML správně zpracovala hlavičku SOAP. (Zděděno od SoapHeader)
Element	Získá nebo nastaví XML Header element pro požadavek SOAP nebo odpověď.
EncodedMustUnderstand	Získá nebo nastaví hodnotu atributu mustUnderstand XML pro hlavičku SOAP při komunikaci s protokolem SOAP verze 1.1. (Zděděno od SoapHeader)
EncodedMustUnderstand12	Získá nebo nastaví hodnotu mustUnderstand atributu XML pro hlavičku SOAP při komunikaci s protokolem SOAP verze 1.2. (Zděděno od SoapHeader)
EncodedRelay	Získá nebo nastaví relé atribut hlavičky SOAP 1.2. (Zděděno od SoapHeader)
MustUnderstand	Získá nebo nastaví hodnotu určující, zda SoapHeader musí být srozumitelný. (Zděděno od SoapHeader)
Relay	Získá nebo nastaví hodnotu, která označuje, zda má být hlavička SOAP předána do dalšího uzlu SOAP, pokud aktuální uzel nerozumí záhlaví. (Zděděno od SoapHeader)
Role	Získá nebo nastaví příjemce hlavičky SOAP. (Zděděno od SoapHeader)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• SoapHeaderAttribute
• SoapHeader