SoapHeaderAttribute.MemberName プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SoapHeaderAttribute.MemberName プロパティ

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

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Property MemberName As
 String

Visual Basic (使用法)

Dim instance As SoapHeaderAttribute
Dim value As String

value = instance.MemberName

instance.MemberName = value

public string MemberName { get;
 set; }

C++

public:
property String^ MemberName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_MemberName ()

/** @property */
public void set_MemberName (String value)

JScript

public function get MemberName
 () : String

public function set MemberName
 (value : String)

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

解説

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

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

使用例

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

Visual Basic

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

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 <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(){}

};

import System.*;
import System.Web.Services.*;
import 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 extends SoapHeader
{
    public String myValue;
} //MyHeader

public class MyWebService
{
    // Member variable to receive the contents of the MyHeader SOAP
 header.
    public MyHeader myHeader;

    /** @attribute WebMethod()
     */
    /** @attribute SoapHeader("myHeader", Direction = SoapHeaderDirection.InOut)
     */

    public void Hello()
    {
    } //Hello
} //MyWebService