SoapHeader 类

定义

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 Web service MyHeader定义 SOAP 标头, 并要求它与对 XML Web service 方法的MyWebMethod任何调用一起发送。The following MyWebService XML Web service defines the MyHeader SOAP header and requires it to be sent with any calls to the MyWebMethod XML Web service method. 此外, MyWebMethod还会接收 soap 标头以外MyHeader的任何 soap 标头。Additionally, MyWebMethod receives any SOAP headers other than the MyHeader SOAP header.

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

注解

如果数据与 XML Web service 方法的主要功能无关, 则 SOAP 标头提供一种方法, 用于将数据传入和向 XML Web service 方法传递数据。SOAP headers offer a method for passing data to and from an XML Web service method if the data is not directly related to the XML Web service method's primary functionality. 例如, XML Web service 可能包含若干 XML Web service 方法, 每个方法都需要自定义身份验证方案。For instance, an XML Web service might contain several XML Web service methods that each require a custom authentication scheme. 不是将参数添加到自定义身份验证方案的每个 XML Web service SoapHeaderAttribute方法, 而是引用SoapHeader派生自的类, 可应用于每个 XML Web service 方法。Instead of adding parameters to each XML Web service method for the custom authentication scheme, a SoapHeaderAttribute, referring to a class deriving from SoapHeader, can be applied to each XML Web service method. 派生自的类的实现SoapHeader处理自定义的身份验证方案。The implementation for the class deriving from SoapHeader handles the custom authentication scheme. 通过这种方式, XML Web service 方法仅实现特定于该方法的功能, 并使用 SOAP 标头添加附加功能。In this manner, the XML Web service method implements only the functionality specific to it and adds additional functionality using a SOAP header.

以下列表概述了接收和处理 SOAP 标头的基本步骤:The following list outlines the basic steps to receiving and processing a SOAP header:

1. 创建一个派生自SoapHeader的类, 该类表示传入 SOAP 标头的数据。Create a class that derives from SoapHeader representing the data passed into the SOAP header.

2. 向实现第一步中创建的类型的 XML Web service 或 XML Web service 客户端代理类的类添加成员。Add a member to the class implementing an XML Web service or an XML Web service client proxy class, of the type created in the first step.

3. 将应用MemberName到代理类中的 XML Web service 方法或相应方法, 并指定在属性的第二步中创建的成员。 SoapHeaderAttributeApply a SoapHeaderAttribute to the XML Web service method or the corresponding method in the proxy class, specifying the member created in the second step in the MemberName property.

4. 在 XML Web service 方法或 XML Web service 客户端代码中, 访问MemberName属性来处理 SOAP 标头中发送的数据。Within the XML Web service method or XML Web service client code, access the MemberName property to process the data sent in the SOAP header.

构造函数

属性

方法

适用于

另请参阅

• SoapUnknownHeader
• SoapHeaderException
• SoapHeaderAttribute
• SoapHeaderDirection