SoapHeader.Actor Eigenschap

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

Waarde van eigenschap

De ontvanger van de SOAP-header. De standaardwaarde is een lege tekenreeks ("").

Voorbeelden

De volgende XML-webserviceclient roept de MyWebMethod XML-webservicemethode aan nadat u een aangepaste SOAP-header van het type hebt MyHeader gemaakt en de Actor eigenschap hebt ingesteld op 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

Opmerkingen

Als u de ontvanger van een SOAP-header wilt instellen, stelt u de Actor eigenschap in. Ongeacht de versie van het SOAP-protocol dat wordt gebruikt om te communiceren met een XML-webservice, genereert het .NET Framework automatisch het SOAP-bericht dat specifiek is voor de versie van het SOAP-protocol. Met name het XML-element en de XML-naamruimte die de ontvanger vertegenwoordigt, verschillen voor de twee versies.

XML-webservices die de SOAP-header ontvangen, kunnen de beoogde ontvanger krijgen door de Role of Actor eigenschappen op te halen.

De geadresseerden voor het Body element en alle SOAP-headers binnen het Header element van een SOAP-bericht hoeven niet hetzelfde te zijn. Als er een Header element in het SOAP-bericht bestaat, vertegenwoordigt het aanvullende gegevens die kunnen worden verzonden naar en van de XML-webservicemethode of een intermediair. De ontvanger van die gegevens, ook wel soap Actor genoemd in versie 1.1, kan een andere URI zijn dan de URI voor de XML-webservicemethode.

Zie de SOAP-specificatie voor meer informatie over het SOAP-kenmerkactor.