SoapHeader.Role Egenskap

Definition

Hämtar eller anger mottagaren av SOAP-huvudet.

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

Egenskapsvärde

En URI som representerar mottagaren av SOAP-huvudet. Standardvärdet är en tom sträng ("").

Attribut

Kommentarer

Ange egenskapen för att ställa in mottagaren av ett SOAP-huvud Actor . Oavsett vilken version av SOAP-protokollet som används för att kommunicera med en XML-webbtjänst genererar .NET Framework automatiskt SOAP-meddelandet som är specifikt för versionen av SOAP-protokollet. Mer specifikt skiljer sig XML-elementet och XML-namnområdet som representerar mottagaren åt för de två versionerna.

XML-webbtjänster som tar emot SOAP-huvudet kan hämta den avsedda mottagaren genom att hämta antingen Role egenskaperna eller Actor .

Mottagarna för elementet Body och var och en av SOAP-huvudena i elementet i Header ett SOAP-meddelande behöver inte vara desamma. Om det finns ett Header element i SOAP-meddelandet representerar det ytterligare data som kan skickas till och från XML-webbtjänstmetoden eller en mellanhand. Mottagaren av dessa data, som kallas SOAP Role i version 1.2 av SOAP-specifikationen och SOAP Actor i version 1.1, kan vara en annan URI än URI:n för XML-webbtjänstmetoden.

Mer information om SOAP-attributet actor finns i SOAP-specifikationen .

Gäller för