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.
Dient zum Abrufen oder Festlegen des Empfängers der SOAP-Kopfzeile.
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
Wenn Sie den Empfänger einer SOAP-Kopfzeile festlegen möchten, 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 .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 gewünschten Empfänger abrufen, indem entweder die Role Eigenschaften abgerufen werden Actor .
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 Zwischendienst gesendet werden können. Der Empfänger dieser Daten, der als SOAP in Version 1.2 der SOAP-Spezifikation Role und der SOAP Actor in Version 1.1 bezeichnet wird, kann ein anderer URI als der URI für die XML-Webdienstmethode sein.
Weitere Informationen zum SOAP-Attribut finden Sie in der SOAP-Spezifikationactor.
