共用方式為


SoapHeaderAttribute(String) 建構函式

定義

設定表示 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 服務會定義類型之 MyHeaderSoapHeaderHelloXML 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 標頭的內容,成員會新增至衍生自 SoapHeaderType XML Web 服務類別。 同樣地,XML Web 服務用戶端會將成員新增至衍生自 SoapHeader 的 Proxy 類別。 衍生 TypeSoapHeader 代表 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 或任一類別的陣列。

適用於