SoapHeader.Role 属性

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

获取或设置 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

属性值

String

一个 URI，表示 SOAP 标头的接收者。 默认值为空字符串("")。

属性

ComVisibleAttribute

注解

若要设置 SOAP 标头的收件人，请设置 Actor 属性。 无论用于与 XML Web 服务通信的 SOAP 协议版本如何，.NET Framework都会自动生成特定于 SOAP 协议版本的 SOAP 消息。 具体而言，表示接收方的 XML 元素和 XML 命名空间在两个版本中有所不同。

接收 SOAP 标头的 XML Web 服务可以通过获取 或 Actor 属性来获取Role目标收件人。

接收方 (元素的) Body ，SOAP 消息的 元素中的每个 Header SOAP 标头不需要相同。 Header如果 SOAP 消息中存在元素，则表示可以发送到 XML Web 服务方法或中介的其他数据。 该数据的接收者（在 SOAP 规范版本 1.2 中称为 SOAP Role ）和 1.1 版中的 SOAP Actor ，可以是与 XML Web 服务方法的 URI 不同的 URI。

有关 SOAP actor 属性的详细信息，请参阅 SOAP 规范。