SoapHeaderAttribute.MemberName 屬性

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

取得或設定 XML Web Service 類別的成員，表示 SOAP 標頭內容。

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

XML Web Service 類別的成員，表示 SOAP 標頭內容。 沒有預設值。

範例

下列 MyWebService XML Web 服務會定義類型之 MyHeader 一 SoapHeader 。 HelloXML 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 服務用戶端可以藉由將 套用 SoapHeaderAttribute 至 XML Web 服務類別中的 XML Web 服務方法或 Proxy 類別中的對應方法，來指定它想要處理的 SOAP 標頭。 為了讓 XML Web 服務方法接收 SOAP 標頭的內容，成員會新增至衍生自 SoapHeader 之型別的 XML Web 服務類別。 同樣地，XML Web 服務用戶端會將成員新增至衍生自 SoapHeader 的 Proxy 類別。 Type衍生自 SoapHeader 代表 SOAP 標頭的內容，並由想要接收 SOAP 標頭的 XML Web 服務或 XML Web 服務用戶端的開發人員所建立。 建立類別之後， SoapHeaderAttribute 即可將 套用至 XML Web 服務方法或 XML Web 服務用戶端 Proxy 類別中的對應方法，以指定成員來接收具有 屬性的 SOAP 標頭內容 MemberName 。

XML Web 服務方法可以藉由將多個成員新增至 XML Web 服務類別或 XML Web 服務 Proxy 類別，然後將多個屬性套用至 XML Web 服務方法，來接收多個 SoapHeaderAttribute SOAP 標頭。

若要在寫入 XML Web 服務時接收及處理未知的 SOAP 標頭，請指定要為 的成員 SoapUnknownHeader 類型， SoapHeader 或任一類別的陣列。