SoapHeader.Role Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Role As StringEigenschaftswert
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 .
