SoapHeader.Role Propiedad

Definición

Espacio de nombres:

System.Web.Services.Protocols

Ensamblado:

System.Web.Services.dll

Obtiene o establece el destinatario del encabezado 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 de propiedad

String

Identificador URI que representa al destinatario del encabezado SOAP. El valor predeterminado es una cadena vacía ("").

Atributos

ComVisibleAttribute

Comentarios

Para establecer el destinatario de un encabezado SOAP, establezca la Actor propiedad . Independientemente de la versión del protocolo SOAP utilizado para comunicarse con un servicio web XML, el .NET Framework genera automáticamente el mensaje SOAP específico de la versión del protocolo SOAP. En concreto, el elemento XML y el espacio de nombres XML que representan al destinatario difieren para las dos versiones.

Los servicios web XML que reciben el encabezado SOAP pueden obtener el destinatario previsto obteniendo las Role propiedades o Actor .

Los destinatarios del Body elemento y cada uno de los encabezados SOAP dentro del Header elemento de un mensaje SOAP no deben ser los mismos. Si existe un Header elemento en el mensaje SOAP, representa datos adicionales que se pueden enviar a y desde el método de servicio web XML o un intermediario. El destinatario de esos datos, conocido como SOAP Role en la versión 1.2 de la especificación SOAP y soap Actor de la versión 1.1, puede ser un URI diferente al URI para el método de servicio web XML.

Para obtener más información sobre el atributo SOAP, consulte la especificación SOAPactor.