SoapHeader.Actor Propriedade

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

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

String

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

Exemplos

O cliente de serviço Web XML a seguir chama o MyWebMethod método de serviço Web XML depois de criar um cabeçalho SOAP personalizado do tipo MyHeader e definir a Actor propriedade como 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

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 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 .