SoapHeader.Role Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 .