SoapHeader.Role Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de ontvanger van de SOAP-header op of stelt u deze in.
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 StringWaarde van eigenschap
Een URI die de ontvanger van de SOAP-header vertegenwoordigt. De standaardwaarde is een lege tekenreeks ("").
- Kenmerken
Opmerkingen
Als u de ontvanger van een SOAP-header wilt instellen, stelt u de Actor eigenschap in. Ongeacht de versie van het SOAP-protocol dat wordt gebruikt om te communiceren met een XML-webservice, genereert het .NET Framework automatisch het SOAP-bericht dat specifiek is voor de versie van het SOAP-protocol. Met name het XML-element en de XML-naamruimte die de ontvanger vertegenwoordigt, verschillen voor de twee versies.
XML-webservices die de SOAP-header ontvangen, kunnen de beoogde ontvanger krijgen door de Role of Actor eigenschappen op te halen.
De geadresseerden voor het Body element en alle SOAP-headers binnen het Header element van een SOAP-bericht hoeven niet hetzelfde te zijn. Als er een Header element in het SOAP-bericht bestaat, vertegenwoordigt het aanvullende gegevens die kunnen worden verzonden naar en van de XML-webservicemethode of een intermediair. De ontvanger van deze gegevens, ook wel soap Role genoemd in versie 1.2 van de SOAP-specificatie en soap Actor in versie 1.1, kan een andere URI zijn dan de URI voor de XML-webservicemethode.
Zie de SOAP-specificatie voor meer informatie over het SOAP-kenmerkactor.