SoapHeader.Role Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta il destinatario dell'intestazione 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

Valore della proprietà

String

URI che rappresenta il destinatario dell'intestazione SOAP. Il valore predefinito è una stringa vuota ("").

Attributi

ComVisibleAttribute

Commenti

Per impostare il destinatario di un'intestazione SOAP, impostare la Actor proprietà . Indipendentemente dalla versione del protocollo SOAP usata per comunicare con un servizio Web XML, .NET Framework genera automaticamente il messaggio SOAP specifico per la versione del protocollo SOAP. In particolare, l'elemento XML e lo spazio dei nomi XML che rappresentano il destinatario differiscono per le due versioni.

I servizi Web XML che ricevono l'intestazione SOAP possono ottenere il destinatario previsto ottenendo le Role proprietà o Actor .

I destinatari per l'elemento e ognuna delle intestazioni SOAP all'interno Header dell'elemento Body di un messaggio SOAP non deve essere la stessa. Se nel messaggio SOAP esiste un Header elemento, rappresenta dati aggiuntivi che possono essere inviati a e dal metodo del servizio Web XML o da un intermediario. Il destinatario di tali dati, noto come SOAP Role nella versione 1.2 della specifica SOAP e del SOAP Actor nella versione 1.1, può essere un URI diverso rispetto all'URI per il metodo del servizio Web XML.

Per altre informazioni sull'attributo SOAP actor , vedere la specifica SOAP .