SoapHeaderAttribute(String) 构造函数

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

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

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 services 类的成员。 MemberName 属性将被设置为此参数的值。

示例

以下 MyWebService XML Web 服务定义 类型MyHeader之一SoapHeader。 Hello XML Web 服务方法将 成员指定myHeader为 MemberName 属性，以接收传递到 XML Web service 方法的 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 服务可以通过将 应用于 SoapHeaderAttribute XML Web service 类中的 XML Web service 方法或代理类中的相应方法，来指定它要为特定 XML Web 服务方法处理的 SOAP 标头。 为了使 XML Web 服务方法接收 SOAP 标头的内容，将成员添加到派生自 SoapHeader的 的 Type XML Web 服务类中。 同样，XML Web 服务客户端将成员添加到派生自 SoapHeader的代理类。 Type派生自 SoapHeader 表示 SOAP 标头的内容，由要接收 SOAP 标头的 XML Web 服务或 XML Web 服务客户端的开发人员创建。 创建类后， SoapHeaderAttribute 可以将 应用于 XML Web 服务方法或 XML Web 服务客户端代理类中的相应方法，以指定成员以接收具有 memberName 此构造函数或 MemberName 属性的 参数的 SOAP 标头内容。

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

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