SoapUnknownHeader 클래스

정의

네임스페이스:

System.Web.Services.Protocols

어셈블리:

System.Web.Services.dll

수신자 XML Web services나 XML Web services 클라이언트가 인식하지 못한 SOAP 헤더에서 받은 데이터를 나타냅니다. 이 클래스는 상속될 수 없습니다.

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

상속

Object

SoapHeader

SoapUnknownHeader

예제

MyWebService XML 웹 서비스를 받고 처리 합니다 MyHeader 에 대 한 모든 호출을 사용 하 여 보낸 SOAP 헤더를 MyWebMethod XML 웹 서비스 메서드. 또한 MyWebMethod 이외의 모든 SOAP 헤더를 수신 합니다 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

설명

SOAP 클라이언트가 SOAP 헤더의 형태로 필요한 매개 변수를 초과 하 여 추가 데이터를 사용 하 여 XML 웹 서비스를 호출할 수 있습니다. ASP.NET 또는 XML 웹 서비스 클라이언트를 사용 하 여 만든 XML 웹 서비스를 해당 몰랐기 XML 웹 서비스를 적용 하 여 작성 된 모든 SOAP 헤더를 볼 수는 SoapHeaderAttribute 사용 하 여는 MemberName 속성의 배열 이거나 SoapHeader를 SoapHeader하십시오 SoapUnknownHeader 또는 배열을 SoapUnknownHeader XML 웹 서비스 메서드에 합니다. 지정 된 Type 의 SoapUnknownHeader, XML 웹 서비스의 형태로 SOAP 헤더의 내용을 볼 수 있습니다는 XmlElement.

생성자

SoapUnknownHeader()

SoapUnknownHeader 클래스의 새 인스턴스를 초기화합니다.

속성

Actor	SOAP 헤더의 수신자를 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
DidUnderstand	XML Web services 메서드가 SOAP 헤더를 올바르게 처리했는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
Element	SOAP 요청 또는 응답에 대한 XML 헤더 요소를 가져오거나 설정합니다.
EncodedMustUnderstand	SOAP 프로토콜 버전 1.1을 사용하여 통신할 때 SOAP 헤더에 대한 mustUnderstand XML 특성의 값을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
EncodedMustUnderstand12	SOAP 프로토콜 버전 1.2를 사용하여 통신할 때 SOAP 헤더에 대한 mustUnderstand XML 특성의 값을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
EncodedRelay	SOAP 1.2 헤더의 릴레이 특성을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
MustUnderstand	SoapHeader를 인식해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
Relay	현재 노드에서 헤더가 인식되지 않을 경우 SOAP 헤더를 다음 SOAP 노드로 릴레이하는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)
Role	SOAP 헤더의 수신자를 가져오거나 설정합니다. (다음에서 상속됨 SoapHeader)

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• SoapHeaderAttribute
• SoapHeader