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 服務可以藉由取得 Role 或 Actor 屬性來取得預定的收件者。

專案和 SOAP 訊息元素內 Header 每個 SOAP 標頭的收件者 () Body 不需要相同。 Header如果元素存在於 SOAP 訊息中，它代表可以傳送至 XML Web 服務方法或媒介的其他資料。 該資料的收件者，在 SOAP 規格 1.2 版中稱為 SOAP Role ，而 1.1 版中的 SOAP Actor 與 XML Web 服務方法的 URI 不同。

如需 SOAP actor 屬性的詳細資訊，請參閱 SOAP 規格。