SoapHeader.Role プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SOAP ヘッダーの受信者を取得または設定します。
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。 既定値は、空の文字列 ("") です。
- 属性
注釈
SOAP ヘッダーの受信者を設定するには、 プロパティを Actor 設定します。 XML Web サービスとの通信に使用される SOAP プロトコルのバージョンに関係なく、.NET Frameworkは SOAP プロトコルのバージョンに固有の SOAP メッセージを自動的に生成します。 具体的には、受信者を表す XML 要素と XML 名前空間は、2 つのバージョンで異なります。
SOAP ヘッダーを受け取る XML Web サービスは、 プロパティまたは Actor プロパティを取得することで、目的の受信者をRole取得できます。
要素の Body
受信者と、SOAP メッセージの要素内 Header
の各 SOAP ヘッダーは同じである必要はありません。 SOAP メッセージに Header
要素が存在する場合は、XML Web サービス メソッドまたは中間者との間で送受信できる追加データを表します。 そのデータの受信者 (SOAP 仕様のバージョン 1.2 では SOAP Role
、バージョン 1.1 では SOAP Actor
) は、XML Web サービス メソッドの URI とは異なる URI にすることができます。
SOAP 属性の詳細については、SOAPactor
の仕様を参照してください。
適用対象
.NET