SoapHeaderAttribute.MemberName 属性

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

获取或设置表示 SOAP 标头内容的 XML Web services 类的成员。

public:
 property System::String ^ MemberName { System::String ^ get(); void set(System::String ^ value); };

public string MemberName { get; set; }

member this.MemberName : string with get, set

Public Property MemberName As String

属性值

String

表示 SOAP 标头内容的 XML Web services 类的成员。 没有默认值。

示例

以下 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 服务类中的 XML Web 服务方法或代理类中的相应方法，来指定要处理的 SOAP 标头。 为了使 XML Web 服务方法能够接收 SOAP 标头的内容，将成员添加到派生自 SoapHeader的类型的 XML Web 服务类中。 同样，XML Web 服务客户端将成员添加到派生自 SoapHeader的代理类。 Type派生自 SoapHeader 表示 SOAP 标头的内容，由要接收 SOAP 标头的 XML Web 服务或 XML Web 服务客户端的开发人员创建。 创建类后， SoapHeaderAttribute 可以将 应用于 XML Web 服务方法或 XML Web 服务客户端代理类中的相应方法，以指定成员以使用 MemberName 属性接收 SOAP 标头内容。

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

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