SoapHeaderAttribute(String) 建構函式

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

初始化該類別的新實例 SoapHeaderAttribute ，並將 XML Web 服務類別的成員設為代表 SOAP 標頭內容的成員。

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 服務類別中代表 SOAP 標頭內容的成員。 屬性 MemberName 會被設定為該參數的值。

範例

以下 MyWebService XML Web 服務定義了一個 SoapHeader 型別 MyHeader為 的 。 Hello XML Web 服務方法指定成員myHeader為MemberName接收傳送至 XML Web 服務方法的 SOAP 標頭內容MyHeader的屬性。

#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 服務可以透過在 XML Web 服務類別中套用 A SoapHeaderAttribute 來指定想要處理的特定 XML Web 服務標頭，或在代理類別中套用相應的方法。 為了讓 XML Web 服務方法接收 SOAP 標頭的內容，會加入一個SoapHeader成員到 從 S 衍生的 XML Web 服務類別Type中。 同樣地，XML Web 服務用戶端會為代理類別新增成員，該成員由 SoapHeader衍生而來。 該 Type 衍生來源 SoapHeader 代表 SOAP 標頭的內容，由 XML Web 服務的開發者或希望接收 SOAP 標頭的 XML Web 服務客戶端所建立。 建立類別後，可以對 XML Web 服務方法或 XML Web 服務代理類別中的對應方法套用 a SoapHeaderAttribute ，指定成員接收 SOAP 標頭內容，並以 memberName 該建構子或 MemberName 屬性的參數。

XML Web 服務方法可以透過在 XML Web 服務類別或 XML Web 服務代理類別中加入多個成員，並對 XML Web 服務方法套用多個 SoapHeaderAttribute 屬性來接收多個 SOAP 標頭。

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