SoapHeaderAttribute.MemberName プロパティ

定義

名前空間:

System.Web.Services.Protocols

アセンブリ:

System.Web.Services.dll

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

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

public string MemberName { get; set; }

member this.MemberName : string with get, set

Public Property MemberName As String

プロパティ値

String

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

例

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

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

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