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

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)

パラメーター

例

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

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

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

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