SoapUnknownHeader Klasa

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Reprezentuje dane odebrane z nagłówka protokołu SOAP, które nie były zrozumiałe dla odbiorcy usługi sieci Web XML lub klienta usługi sieci Web XML XML. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

SoapHeader

SoapUnknownHeader

Przykłady

MyWebService Usługa sieci Web XML akceptuje i przetwarza MyHeader nagłówek SOAP wysyłany z dowolnymi wywołaniami MyWebMethod metody usługi sieci Web XML. MyWebMethod Ponadto odbiera wszystkie nagłówki PROTOKOŁU SOAP inne niż MyHeader nagłówek PROTOKOŁU 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

Uwagi

Klient protokołu SOAP może wywołać usługę sieci Web XML z dodatkowymi danymi poza wymaganymi parametrami w postaci nagłówka PROTOKOŁU SOAP. Usługa sieci Web XML utworzona przy użyciu ASP.NET lub klienta usługi sieci Web XML może wyświetlać wszystkie nagłówki protokołu SOAP, o których nie wiedział w momencie zapisu usługi sieci Web XML, stosując SoapHeaderAttribute właściwość z MemberName właściwością SoapHeadertablicy , SoapHeaderSoapUnknownHeader lub tablicy SoapUnknownHeader do metody usługi sieci Web XML. Określenie elementu Type SoapUnknownHeaderumożliwia usłudze sieci Web XML wyświetlanie zawartości nagłówka PROTOKOŁU SOAP w postaci XmlElementelementu .

Konstruktory

SoapUnknownHeader()

Inicjuje nowe wystąpienie klasy SoapUnknownHeader.

Właściwości

Actor	Pobiera lub ustawia adresata nagłówka PROTOKOŁU SOAP. (Odziedziczone po SoapHeader)
DidUnderstand	Pobiera lub ustawia wartość wskazującą, czy metoda usługi sieci Web XML prawidłowo przetworzyła nagłówek SOAP. (Odziedziczone po SoapHeader)
Element	Pobiera lub ustawia element nagłówka XML dla żądania lub odpowiedzi protokołu SOAP.
EncodedMustUnderstand	Pobiera lub ustawia wartość atrybutu mustUnderstand XML nagłówka protokołu SOAP podczas komunikacji z protokołem SOAP w wersji 1.1. (Odziedziczone po SoapHeader)
EncodedMustUnderstand12	Pobiera lub ustawia wartość atrybutu mustUnderstand XML nagłówka protokołu SOAP podczas komunikacji z protokołem SOAP w wersji 1.2. (Odziedziczone po SoapHeader)
EncodedRelay	Pobiera lub ustawia atrybut przekaźnika nagłówka SOAP 1.2. (Odziedziczone po SoapHeader)
MustUnderstand	Pobiera lub ustawia wartość wskazującą, czy SoapHeader element musi być zrozumiały. (Odziedziczone po SoapHeader)
Relay	Pobiera lub ustawia wartość wskazującą, czy nagłówek PROTOKOŁU SOAP ma zostać przekazany do następnego węzła SOAP, jeśli bieżący węzeł nie rozumie nagłówka. (Odziedziczone po SoapHeader)
Role	Pobiera lub ustawia adresata nagłówka PROTOKOŁU SOAP. (Odziedziczone po SoapHeader)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• SoapHeaderAttribute
• SoapHeader