SoapHeader.Role Właściwość

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Pobiera lub ustawia adresata nagłówka PROTOKOŁU 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

Wartość właściwości

String

Identyfikator URI, który reprezentuje adresata nagłówka SOAP. Wartością domyślną jest ciąg pusty ("").

Atrybuty

ComVisibleAttribute

Uwagi

Aby ustawić adresata nagłówka protokołu SOAP, ustaw Actor właściwość . Niezależnie od wersji protokołu SOAP używanego do komunikowania się z usługą sieci Web XML, .NET Framework automatycznie generuje komunikat SOAP specyficzny dla wersji protokołu SOAP. W szczególności element XML i przestrzeń nazw XML reprezentująca adresata różnią się w przypadku dwóch wersji.

Usługi sieci Web XML odbierające nagłówek SOAP mogą uzyskać zamierzonego adresata, pobierając Role właściwości lub Actor .

Adresaci elementu Body i każdego nagłówka protokołu SOAP w Header elemecie komunikatu SOAP nie muszą być takie same. Header Jeśli element istnieje w komunikacie SOAP, reprezentuje dodatkowe dane, które można wysłać do i z metody usługi sieci Web XML lub pośrednika. Odbiorca tych danych, znany jako SOAP w wersji 1.2 specyfikacji SOAP Role i SOAP Actor w wersji 1.1, może być innym identyfikatorem URI niż identyfikator URI dla metody usługi sieci Web XML.

Aby uzyskać więcej informacji na temat atrybutu SOAP, zobacz specyfikację protokołu SOAPactor.