SoapHeaderAttribute コンストラクタとは何？わかりやすく解説 Weblio辞書

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

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

SoapHeaderAttribute コンストラクタ

SOAP ヘッダーの内容を表す XML Web サービスクラスのメンバを設定して、SoapHeaderAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    memberName As String _
)

Visual Basic (使用法)

Dim memberName As String

Dim instance As New SoapHeaderAttribute(memberName)

public SoapHeaderAttribute (
    string memberName
)

C++

public:
SoapHeaderAttribute (
    String^ memberName
)

public SoapHeaderAttribute (
    String memberName
)

JScript

public function SoapHeaderAttribute (
    memberName : String
)

パラメータ

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

解説

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

XML Web サービスの書き込み時に不明な SOAP ヘッダーの受信や処理を行うには、メンバの Type を 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