SoapHeader.Actor 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 ^ Actor { System::String ^ get(); void set(System::String ^ value); };

public string Actor { get; set; }

member this.Actor : string with get, set

Public Property Actor As String

Valor de propiedad

String

Destinatario del encabezado SOAP. El valor predeterminado es una cadena vacía ("").

Ejemplos

El siguiente cliente de servicio web XML llama al MyWebMethod método de servicio web XML después de crear un encabezado SOAP personalizado de tipo MyHeader y establecer la Actor propiedad en http://www.contoso.com/MySoapHeaderHandler.

int main()
{
   MyWebService^ ws = gcnew MyWebService;
   try
   {
      MyHeader^ customHeader = gcnew MyHeader;
      customHeader->MyValue = "Header Value for MyValue";
      customHeader->Actor = "http://www.contoso.com/MySoapHeaderHandler";
      ws->myHeader = customHeader;
      int results = ws->MyWebMethod( 3, 5 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e );
   }

}

using System;

public class Sample {

    public static void Main() {
        MyWebService ws = new MyWebService();

        try {
            MyHeader customHeader = new MyHeader();
            customHeader.MyValue = "Header Value for MyValue";
            customHeader.Actor = "http://www.contoso.com/MySoapHeaderHandler";
            ws.myHeader = customHeader;

        int results = ws.MyWebMethod(3,5);
        }
        catch (Exception e) {
            Console.WriteLine ("Exception: {0}", e.ToString());
        }
    }
}

Public Class Sample
    
    Public Shared Sub Main()
        Dim ws As New MyWebService()

        Try
            Dim customHeader As New MyHeader1()

            customHeader.MyValue = "Header Value for MyValue"
            customHeader.Actor = "http://www.contoso.com/MySoapHeaderHandler"

            ws.myHeader = customHeader

        Dim results As Integer

            results = ws.MyWebMethod(3,5)
        Catch e As Exception
            Console.WriteLine("Exception: {0}", e.ToString())
        End Try
    End Sub
End Class

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 Actor en la versión 1.1, puede ser un URI diferente al URI del método de servicio web XML.

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