SoapHeader.Role プロパティ

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

[System.Runtime.InteropServices.ComVisible(false)]
public string Role { get; set; }

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Role : string with get, set

Public Property Role As String

プロパティ値

SOAP ヘッダーの受信者を表す URI。 既定値は空の文字列 ("") です。

属性

ComVisibleAttribute

注釈

SOAP ヘッダーの受信者を設定するには、 Actor プロパティを設定します。 XML Web サービスとの通信に使用される SOAP プロトコルのバージョンに関係なく、.NET Framework は SOAP プロトコルのバージョンに固有の SOAP メッセージを自動的に生成します。 具体的には、受信者を表す XML 要素と XML 名前空間は、2 つのバージョンで異なります。

SOAP ヘッダーを受信する XML Web サービスは、 Role プロパティまたは Actor プロパティを取得することで、目的の受信者を取得できます。

Body要素の受信者と、SOAP メッセージのHeader要素内の各 SOAP ヘッダーは同じである必要はありません。 SOAP メッセージに Header 要素が存在する場合は、XML Web サービス メソッドまたは中継局との間で送受信できる追加のデータを表します。 SOAP 仕様のバージョン 1.2 の SOAP Role 、およびバージョン 1.1 の SOAP Actor と呼ばれるそのデータの受信者は、XML Web サービス メソッドの URI とは異なる URI にすることができます。

SOAP actor 属性の詳細については、 SOAP の仕様を参照してください。