SoapUnknownHeader Sınıf

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

Alıcı XML Web hizmeti veya XML Web hizmeti istemcisi tarafından anlaşılmayan bir SOAP üst bilgisinden alınan verileri temsil eder. Bu sınıf devralınamaz.

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

Devralma

Object

SoapHeader

SoapUnknownHeader

Örnekler

MyWebService XML Web hizmeti, XML Web hizmeti yöntemine MyWebMethod yapılan MyHeader çağrılarla gönderilen SOAP üst bilgisini kabul eder ve işler. Ayrıca, MyWebMethod SOAP üst bilgisi dışında MyHeader tüm SOAP üst bilgilerini alır.

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

Açıklamalar

SOAP istemcisi, SOAP üst bilgisi biçiminde gerekli parametrelerin ötesinde ek verilerle bir XML Web hizmeti çağırabilir. ASP.NET veya XML Web hizmeti istemcisi kullanılarak oluşturulan bir XML Web hizmeti, XML Web hizmeti yöntemine , veya dizisinin bir özelliğine sahip bir SoapHeaderAttribute MemberName özelliği SoapUnknownHeader SoapHeaderSoapHeaderuygulayarak XML Web hizmetinin yazıldığı sırada bilmediği SOAP üst bilgilerini görüntüleyebilir.SoapUnknownHeader değerinin Type SoapUnknownHeaderbelirtilmesi, XML Web hizmetinin SOAP üst bilgisinin içeriğini biçiminde XmlElementgörüntülemesine olanak tanır.

Oluşturucular

SoapUnknownHeader()

SoapUnknownHeader sınıfının yeni bir örneğini başlatır.

Özellikler

Actor	SOAP üst bilgisinin alıcısını alır veya ayarlar. (Devralındığı yer: SoapHeader)
DidUnderstand	XML Web hizmeti yönteminin SOAP üst bilgisini düzgün işleyip işlemediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: SoapHeader)
Element	SOAP isteği veya yanıtı için XML Üst Bilgisi öğesini alır veya ayarlar.
EncodedMustUnderstand	SOAP protokolü sürüm 1.1 ile iletişim kurarken SOAP üst bilgisi için XML özniteliğinin değerini mustUnderstand alır veya ayarlar. (Devralındığı yer: SoapHeader)
EncodedMustUnderstand12	SOAP protokolü sürüm 1.2 ile iletişim kurarken SOAP üst bilgisi için XML özniteliğinin değerini mustUnderstand alır veya ayarlar. (Devralındığı yer: SoapHeader)
EncodedRelay	SOAP 1.2 üst bilgisinin geçiş özniteliğini alır veya ayarlar. (Devralındığı yer: SoapHeader)
MustUnderstand	değerinin anlaşılması gerekip gerekmediğini SoapHeader belirten bir değer alır veya ayarlar. (Devralındığı yer: SoapHeader)
Relay	Geçerli düğüm üst bilgiyi anlayamazsa SOAP üst bilgisinin sonraki SOAP düğümüne aktarılıp aktarılmayacağını belirten bir değer alır veya ayarlar. (Devralındığı yer: SoapHeader)
Role	SOAP üst bilgisinin alıcısını alır veya ayarlar. (Devralındığı yer: SoapHeader)

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• SoapHeaderAttribute
• SoapHeader