SoapHeaderAttribute.MemberName プロパティ

SOAP ヘッダーの内容を表す XML Web サービス クラスのメンバを取得または設定します。

Public Property MemberName As String
[C#]
public string MemberName {get; set;}
[C++]
public: __property String* get_MemberName();public: __property void set_MemberName(String*);
[JScript]
public function get MemberName() : String;public function set MemberName(String);

プロパティ値

SOAP ヘッダーの内容を表す XML Web サービス クラスのメンバ。既定値はありません。

解説

XML Web サービスまたは XML Web サービス クライアントは、XML Web サービス クラスの XML Web サービス メソッドまたはプロキシ クラスの対応するメソッドに SoapHeaderAttribute を適用することにより、処理する SOAP ヘッダーを指定できます。XML Web サービス メソッドが SOAP ヘッダーの内容を受信するには、 SoapHeader から派生する型の XML Web サービス クラスにメンバを追加します。同様に、XML Web サービス クライアントは SoapHeader から派生するプロキシ クラスにメンバを追加します。 SoapHeader から派生する Type は、SOAP ヘッダーの内容を表し、SOAP ヘッダーを受信する必要がある XML Web サービスまたは XML Web サービス クライアントの開発者によって作成されます。クラスが作成されると、 MemberName プロパティを使用して SOAP ヘッダーの内容を受信するメンバを指定する、XML Web サービス メソッドまたは XML Web サービス クライアント プロキシ クラスの対応するメソッドに SoapHeaderAttribute を適用できます。

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

XML Web サービスの書き込み時に不明な SOAP ヘッダーの受信や処理を行うには、メンバの型を SoapUnknownHeader 、 SoapHeader 、またはどちらかのクラスの配列に指定します。

使用例

[Visual Basic, C#, C++] MyHeader 型の 1 つの SoapHeader を定義する MyWebService XML Web サービスを次に示します。 Hello XML Web サービス メソッドは、 myHeader メンバを MemberName プロパティとして指定し、XML Web サービス メソッドに渡された MyHeader SOAP ヘッダーの内容を受け取ります。

 
Imports System
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 'MyHeader


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 'Hello
End Class 'MyWebService


[C#] 
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() {
    
    }
}

[C++] 
#using <mscorlib.dll>
#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 __gc class MyHeader : public SoapHeader {
public:
    String* MyValue;
};

public __gc class MyWebService {
    // Member variable to receive the contents of the MyHeader SOAP header.
public:
    MyHeader* myHeader;
 
    [WebMethod]
    [SoapHeader(S"myHeader", Direction=SoapHeaderDirection::InOut)]
    void Hello() {
    
    }
};

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SoapHeaderAttribute クラス | SoapHeaderAttribute メンバ | System.Web.Services.Protocols 名前空間