SoapHeaderAttribute(String) 建構函式

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

設定表示 SOAP 標頭內容的 XML Web Service 類別的成員，初始化 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

XML Web Service 類別的成員，表示 SOAP 標頭內容。 MemberName 屬性將設為這個參數的值。

範例

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

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

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