SoapHeader.Actor Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta il destinatario dell'intestazione 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

Valore della proprietà

String

Destinatario dell'intestazione SOAP. Il valore predefinito è una stringa vuota ("").

Esempio

Il client del servizio Web XML seguente chiama il MyWebMethod metodo del servizio Web XML dopo la creazione di un'intestazione SOAP personalizzata di tipo MyHeader e l'impostazione della Actor proprietà su 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

Commenti

Per impostare il destinatario di un'intestazione SOAP, impostare la Actor proprietà . Indipendentemente dalla versione del protocollo SOAP usata per comunicare con un servizio Web XML, .NET Framework genera automaticamente il messaggio SOAP specifico per la versione del protocollo SOAP. In particolare, l'elemento XML e lo spazio dei nomi XML che rappresentano il destinatario differiscono per le due versioni.

I servizi Web XML che ricevono l'intestazione SOAP possono ottenere il destinatario previsto ottenendo le Role proprietà o Actor .

I destinatari per l'elemento e ognuna delle intestazioni SOAP all'interno Header dell'elemento Body di un messaggio SOAP non deve essere la stessa. Se nel messaggio SOAP esiste un Header elemento, rappresenta dati aggiuntivi che possono essere inviati a e dal metodo del servizio Web XML o da un intermediario. Il destinatario di tali dati, noto come SOAP Actor nella versione 1.1, può essere un URI diverso rispetto all'URI per il metodo del servizio Web XML.

Per altre informazioni sull'attributo SOAP actor , vedere la specifica SOAP .