SoapHeader 클래스

정의

네임스페이스:

System.Web.Services.Protocols

어셈블리:

System.Web.Services.dll

파생 클래스에서 재정의된 경우 SOAP 헤더의 내용을 나타냅니다.

public ref class SoapHeader abstract

public abstract class SoapHeader

type SoapHeader = class

Public MustInherit Class SoapHeader

상속

Object

SoapHeader

파생

System.Web.Services.Protocols.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",Required=false)]

    public string MyWebMethod() {

       foreach (SoapUnknownHeader header in unknownHeaders) {
           // Perform some processing on the header.
       if (header.Element.Name == "MyKnownHeader")
               header.DidUnderstand = true;
       else
                // For those headers that cannot be  
                // processed, set the DidUnderstand property to false.
                header.DidUnderstand = false;
       }
       return "Hello";
    }
}

<%@ 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 theHeader As MyHeader
    ' Receive all SOAP headers besides the MyHeader SOAP header.
    Public unknownHeaders() As SoapUnknownHeader    

    'Receive any SOAP headers other than MyHeader.    
    <WebMethod, _
     SoapHeader("theHeader", Direction := SoapHeaderDirection.InOut), _
     SoapHeader("unknownHeaders")> _
    Public Function MyWebMethod() As String
                
        Dim header As SoapUnknownHeader
        For Each header In unknownHeaders
            ' Perform some processing on the header.
            If header.Element.Name = "MyKnownHeader" Then
                header.DidUnderstand = True
            Else
                ' For those headers that cannot be
                ' processed, set the DidUnderstand propert to false.
                header.DidUnderstand = False
            End If
        Next header
        Return "Hello"
    End Function
    
End Class

설명

SOAP 헤더에는 데이터는 관련이 없는 경우 직접 XML 웹 서비스 메서드의 기본 기능과 XML 웹 서비스 메서드에서 데이터를 전달 하는 방법을 제공 합니다. 예를 들어, XML 웹 서비스를 사용자 지정 인증 체계를 해야 하는 각 여러 XML 웹 서비스 메서드를 포함할 수 있습니다. 각 XML 웹 서비스 메서드에 사용자 지정 인증 체계에 대 한 매개 변수를 추가 하는 대신 한 SoapHeaderAttribute에서 파생 된 클래스를 참조 SoapHeader, 각 XML 웹 서비스 메서드에 적용할 수 있습니다. 파생 된 클래스에 대 한 구현을 SoapHeader 사용자 지정 인증 체계를 처리 합니다. 이런 방식으로 XML 웹 서비스 메서드에 특정 기능만 구현 하 고 SOAP 헤더를 사용 하 여 추가 기능을 추가 합니다.

다음 목록 윤곽선 받아서 SOAP 헤더를 처리 하기 위한 기본 단계:

1. 파생 되는 클래스를 만들고 SoapHeader SOAP 헤더에 전달 된 데이터를 나타내는입니다.

2. XML 웹 서비스를 구현 하는 클래스 또는 XML 웹 서비스 클라이언트 프록시 클래스, 첫 번째 단계에서 만든 형식에 구성원을 추가 합니다.

3. 적용을 SoapHeaderAttribute 는 XML 웹 서비스 메서드나 프록시 클래스에 해당 하는 메서드를 두 번째 단계에서 만든 멤버를 지정 하는 MemberName 속성입니다.

4. XML 웹 서비스 메서드 또는 XML 웹 서비스 클라이언트 코드에서 액세스를 MemberName SOAP 헤더에서 전송 되는 데이터를 처리 하는 속성입니다.

생성자

SoapHeader()

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

속성

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

메서드

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

추가 정보

• SoapUnknownHeader
• SoapHeaderException
• SoapHeaderAttribute
• SoapHeaderDirection