Compartilhar via


SoapHeader.Role Propriedade

Definição

Obtém ou define o destinatário do cabeçalho 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

Valor da propriedade

String

Um URI que representa o destinatário do cabeçalho SOAP. O padrão é uma cadeia de caracteres vazia ("").

Atributos

Comentários

Para definir o destinatário de um cabeçalho SOAP, defina a Actor propriedade. Independentemente da versão do protocolo SOAP usada para se comunicar com um serviço Web XML, o .NET Framework gera automaticamente a mensagem SOAP específica para a versão do protocolo SOAP. Especificamente, o elemento XML e o namespace XML que representa o destinatário diferem para as duas versões.

Os serviços Web XML que recebem o cabeçalho SOAP podem obter o destinatário pretendido obtendo as propriedades ou Actor as Role propriedades.

Os destinatários do Body elemento e de cada um dos cabeçalhos SOAP dentro do Header elemento de uma mensagem SOAP não precisam ser os mesmos. Se existir um Header elemento na mensagem SOAP, ele representará dados adicionais que podem ser enviados de e para o método de serviço Web XML ou um intermediário. O destinatário desses dados, conhecido como SOAP Role na versão 1.2 da especificação SOAP e soap Actor na versão 1.1, pode ser um URI diferente do URI do método de serviço Web XML.

Para obter mais informações sobre o atributo SOAP actor , consulte a especificação SOAP .

Aplica-se a