SoapHeaderAttribute(String) コンストラクター

定義

名前空間:

System.Web.Services.Protocols

アセンブリ:

System.Web.Services.dll

SOAP ヘッダーの内容を表す XML Web サービス クラスのメンバーを設定して、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

SOAP ヘッダーの内容を表す XML Web サービス クラスのメンバー。 MemberName プロパティはこのパラメーターの値に設定されます。

例

次 MyWebService の XML Web サービスは、 型の 1 つ SoapHeader を定義します MyHeader。 XML Web サービス メソッドはHello、XML Web サービス メソッドに渡される SOAP ヘッダーのMyHeader内容を受け取るプロパティとしてMemberNameメンバーを指定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 サービス クラスの XML Web サービス メソッドまたはプロキシ クラスの対応するメソッドに を適用 SoapHeaderAttribute することで、特定の XML Web サービス メソッドに対して処理する SOAP ヘッダーを指定できます。 XML Web サービス メソッドが SOAP ヘッダーの内容を受信するために、 からSoapHeader派生した の XML Web サービス クラスにメンバーがType追加されます。 同様に、XML Web サービス クライアントは、 から SoapHeader派生したプロキシ クラスにメンバーを追加します。 からSoapHeader派生することは Type SOAP ヘッダーの内容を表し、SOAP ヘッダーを受信する XML Web サービスまたは XML Web サービス クライアントの開発者によって作成されます。 クラスが作成されたら、 SoapHeaderAttribute を XML Web サービス クライアント プロキシ クラスの XML Web サービス メソッドまたは対応するメソッドに適用して、このコンストラクターまたは プロパティにパラメーターを指定 memberName して SOAP ヘッダーの内容を受け取るメンバーを MemberName 指定できます。

XML Web サービス メソッドは、XML Web サービス クラスまたは XML Web サービス プロキシ クラスに複数のメンバーを追加し、さらに XML Web サービス メソッドに複数の属性を適用することで、複数 SoapHeaderAttribute の SOAP ヘッダーを受け取ることができます。

XML Web サービスの書き込み時に不明な SOAP ヘッダーを受信して処理するには、メンバーの を Type 、SoapUnknownHeaderSoapHeaderまたはいずれかのクラスの配列として指定します。