SoapHeader.Actor Propriedade

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 Propriedade

O destinatário do cabeçalho SOAP. O padrão é uma cadeia vazia ("").

Exemplos

O seguinte cliente do serviço Web XML chama o MyWebMethod método do serviço Web XML após criar um cabeçalho SOAP personalizado do tipo MyHeader e definir a Actor propriedade para 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

Observações

Para definir o destinatário de um cabeçalho SOAP, defina a Actor propriedade. Independentemente da versão do protocolo SOAP usada para 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 espaço de nomes XML que representam o destinatário diferem nas duas versões.

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

O(s) destinatário(s) do Body elemento e cada um dos cabeçalhos SOAP dentro do Header elemento de uma mensagem SOAP não precisam de ser os mesmos. Se existir um Header elemento na mensagem SOAP, representa dados adicionais que podem ser enviados para e a partir do método do serviço Web XML ou de um intermediário. O destinatário desses dados, conhecido como SOAP Actor na versão 1.1, pode ter um URI diferente do URI do método do serviço Web XML.

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