SoapHeader.Actor Właściwość

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Pobiera lub ustawia adresata nagłówka PROTOKOŁU 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

Wartość właściwości

String

Adresat nagłówka PROTOKOŁU SOAP. Wartością domyślną jest ciąg pusty ("").

Przykłady

Następujący klient usługi sieci Web XML wywołuje metodę MyWebMethod usługi sieci Web XML po utworzeniu niestandardowego nagłówka protokołu SOAP typu MyHeader i ustawieniu Actor właściwości na 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

Uwagi

Aby ustawić adresata nagłówka protokołu SOAP, ustaw Actor właściwość . Niezależnie od wersji protokołu SOAP używanego do komunikowania się z usługą sieci Web XML, .NET Framework automatycznie generuje komunikat SOAP specyficzny dla wersji protokołu SOAP. W szczególności element XML i przestrzeń nazw XML reprezentująca adresata różnią się w przypadku dwóch wersji.

Usługi sieci Web XML odbierające nagłówek SOAP mogą uzyskać zamierzonego adresata, pobierając Role właściwości lub Actor .

Adresaci elementu Body i każdego nagłówka protokołu SOAP w Header elemecie komunikatu SOAP nie muszą być takie same. Header Jeśli element istnieje w komunikacie SOAP, reprezentuje dodatkowe dane, które można wysłać do i z metody usługi sieci Web XML lub pośrednika. Odbiorca tych danych, znany jako SOAP Actor w wersji 1.1, może być innym identyfikatorem URI niż identyfikator URI dla metody usługi sieci Web XML.

Aby uzyskać więcej informacji na temat atrybutu SOAP, zobacz specyfikację protokołu SOAPactor.