SoapHeader.Role Propriété

Définition

Obtient ou définit le destinataire de l'en-tête 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

Valeur de propriété

URI qui représente le destinataire de l'en-tête SOAP. La valeur par défaut est une chaîne vide ("").

Attributs

Remarques

Pour définir le destinataire d’un en-tête SOAP, définissez la Actor propriété . Quelle que soit la version du protocole SOAP utilisée pour communiquer avec un service Web XML, le .NET Framework génère automatiquement le message SOAP spécifique à la version du protocole SOAP. Plus précisément, l’élément XML et l’espace de noms XML représentant le destinataire diffèrent pour les deux versions.

Les services Web XML recevant l’en-tête SOAP peuvent obtenir le destinataire prévu en obtenant les Role propriétés ou Actor .

Le ou les destinataires de l’élément Body et chacun des en-têtes SOAP dans l’élément Header d’un message SOAP n’ont pas besoin d’être identiques. Si un Header élément existe dans le message SOAP, il représente des données supplémentaires qui peuvent être envoyées à et à partir de la méthode de service Web XML ou d’un intermédiaire. Le destinataire de ces données, appelé SOAP Role dans la version 1.2 de la spécification SOAP et SOAP Actor dans la version 1.1, peut être un URI différent de l’URI de la méthode de service Web XML.

Pour plus d’informations sur l’attribut SOAP actor , consultez la spécification SOAP .

S’applique à