SoapUnknownHeader Kelas

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Mewakili data yang diterima dari header SOAP yang tidak dipahami oleh layanan Web XML penerima atau klien layanan Web XML. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

SoapHeader

SoapUnknownHeader

Contoh

Layanan MyWebService Web XML menerima dan memproses header SOAP yang MyHeader dikirim dengan panggilan apa pun ke MyWebMethod metode layanan Web XML. Selain itu, MyWebMethod menerima header SOAP selain MyHeader header 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

Keterangan

Klien SOAP mungkin memanggil layanan Web XML dengan data tambahan di luar parameter yang diperlukan dalam bentuk header SOAP. Layanan Web XML yang dibuat menggunakan ASP.NET atau klien layanan Web XML dapat melihat header SOAP apa pun yang tidak diketahuinya pada saat layanan Web XML ditulis dengan menerapkan SoapHeaderAttribute properti dengan MemberName array SoapHeader, , SoapHeaderSoapUnknownHeader atau array SoapUnknownHeader ke metode layanan Web XML. Type Menentukan , SoapUnknownHeadermemungkinkan layanan Web XML untuk melihat konten header SOAP dalam bentuk XmlElement.

Konstruktor

Nama	Deskripsi
SoapUnknownHeader()	Menginisialisasi instans baru dari kelas SoapUnknownHeader.

Properti

Nama	Deskripsi
Actor	Mendapatkan atau mengatur penerima header SOAP. (Diperoleh dari SoapHeader)
DidUnderstand	Mendapatkan atau menetapkan nilai yang menunjukkan apakah metode layanan Web XML memproses header SOAP dengan benar. (Diperoleh dari SoapHeader)
Element	Mendapatkan atau mengatur elemen Header XML untuk permintaan atau respons SOAP.
EncodedMustUnderstand	Mendapatkan atau mengatur nilai mustUnderstand atribut XML untuk header SOAP saat berkomunikasi dengan protokol SOAP versi 1.1. (Diperoleh dari SoapHeader)
EncodedMustUnderstand12	Mendapatkan atau mengatur nilai mustUnderstand atribut XML untuk header SOAP saat berkomunikasi dengan protokol SOAP versi 1.2. (Diperoleh dari SoapHeader)
EncodedRelay	Mendapatkan atau mengatur atribut relai header SOAP 1.2. (Diperoleh dari SoapHeader)
MustUnderstand	Mendapatkan atau menetapkan nilai yang menunjukkan apakah SoapHeader harus dipahami. (Diperoleh dari SoapHeader)
Relay	Mendapatkan atau menetapkan nilai yang menunjukkan apakah header SOAP akan disampaikan ke simpul SOAP berikutnya jika simpul saat ini tidak memahami header. (Diperoleh dari SoapHeader)
Role	Mendapatkan atau mengatur penerima header SOAP. (Diperoleh dari SoapHeader)

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• SoapHeaderAttribute
• SoapHeader