通过

SoapHeaderAttribute(String) 构造函数

定义

命名空间:
System.Web.Services.Protocols
程序集:
System.Web.Services.dll

初始化类的新实例 SoapHeaderAttribute ，设置表示 SOAP 标头内容的 XML Web 服务类的成员。

public:
 SoapHeaderAttribute(System::String ^ memberName);
public SoapHeaderAttribute(string memberName);
new System.Web.Services.Protocols.SoapHeaderAttribute : string -> System.Web.Services.Protocols.SoapHeaderAttribute
Public Sub New (memberName As String)

参数

memberName
String

表示 SOAP 标头内容的 XML Web 服务类的成员。 该 MemberName 属性将设置为此参数的值。

示例

以下 MyWebService XML Web 服务定义一种 SoapHeader 类型 MyHeader。 Hello XML Web 服务方法将成员指定myHeader为MemberName接收传递到 XML Web 服务方法的 MyHeader SOAP 标头的内容的属性。

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Web::Services;
using namespace System::Web::Services::Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public ref class MyHeader: public SoapHeader
{
public:
   String^ MyValue;
};

public ref class MyWebService
{
public:

   // Member variable to receive the contents of the MyHeader SOAP header.
   MyHeader^ myHeader;

   [WebMethod]
   [SoapHeader("myHeader",Direction=SoapHeaderDirection::InOut)]
   void Hello(){}

};

using System;
using System.Web.Services;
using System.Web.Services.Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {
    // Member variable to receive the contents of the MyHeader SOAP header.
    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]
    public void Hello() {
    }
}

Imports System.Web.Services
Imports System.Web.Services.Protocols

' Define a SOAP header by deriving from the SoapHeader base class.
' The header contains just one string value.
Public Class MyHeader
   Inherits SoapHeader
   Public MyValue As String
End Class


Public Class MyWebService
   ' Member variable to receive the contents of the MyHeader SOAP header.
   Public myHeader As MyHeader

   
   <WebMethod, _ 
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut)> _
   Public Sub Hello()

   End Sub
End Class

注解

XML Web 服务客户端或 XML Web 服务可以通过向 XML Web 服务类中的 XML Web 服务方法或代理类中的相应方法应用 SoapHeaderAttribute XML Web 服务方法来指定要处理的特定 XML Web 服务方法的 SOAP 标头。 为了使 XML Web 服务方法接收 SOAP 标头的内容，成员将添加到派生自SoapHeader的 Type XML Web 服务类。 同样，XML Web 服务客户端将成员添加到派生自 SoapHeader的代理类。 派 Type 生自 SoapHeader 表示 SOAP 标头的内容，由要接收 SOAP 标头的 XML Web 服务或 XML Web 服务客户端的开发人员创建。 创建类后，可以向 XML Web 服务方法或 XML Web 服务客户端代理类中的相应方法应用一个 SoapHeaderAttribute 对象，该类指定成员以接收包含 memberName 此构造函数或 MemberName 属性的参数的 SOAP 标头内容。

XML Web 服务方法可以通过向 XML Web 服务类或 XML Web 服务代理类添加多个成员，并将多个属性应用于 XML Web 服务方法来接收多个 SoapHeaderAttribute SOAP 标头。

若要在编写 XML Web 服务时接收和处理未知 SOAP 标头，请指定要Type为任SoapUnknownHeaderSoapHeader一成员或任一类的数组。

适用于