Freigeben über


SoapHeader.Role Eigenschaft

Definition

Ruft den Empfänger des SOAP-Headers ab oder legt diesen fest.

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

Eigenschaftswert

Ein URI, der den Empfänger des SOAP-Headers darstellt. Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

Hinweise

Um den Empfänger eines SOAP-Headers festzulegen, legen Sie die Actor -Eigenschaft fest. Unabhängig von der Version des SOAP-Protokolls, das für die Kommunikation mit einem XML-Webdienst verwendet wird, generiert der .NET Framework automatisch die SOAP-Nachricht, die für die Version des SOAP-Protokolls spezifisch ist. Insbesondere unterscheiden sich das XML-Element und der XML-Namespace, der den Empfänger darstellt, für die beiden Versionen.

XML-Webdienste, die den SOAP-Header empfangen, können den beabsichtigten Empfänger abrufen, indem sie entweder die Role -Eigenschaft oder Actor abrufen.

Die Empfänger für das Body Element und die einzelnen SOAP-Header innerhalb des Header Elements einer SOAP-Nachricht müssen nicht identisch sein. Wenn ein Header Element in der SOAP-Nachricht vorhanden ist, stellt es zusätzliche Daten dar, die an und von der XML-Webdienstmethode oder einem Vermittler gesendet werden können. Der Empfänger dieser Daten, die in Version 1.2 der SOAP-Spezifikation und SOAP in Version 1.1 als SOAP RoleActor bezeichnet werden, kann ein anderer URI als der URI für die XML-Webdienstmethode sein.

Weitere Informationen zum SOAP-Attribut actor finden Sie in der SOAP-Spezifikation .

Gilt für: