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

Odbiorca nagłówka protokołu SOAP. Wartość domyślna to pusty ciąg ("").

Przykłady

Następujący klient usługi sieci Web XML wywołuje MyWebMethod metodę 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 program .NET Framework automatycznie generuje komunikat PROTOKOŁU 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 PROTOKOŁU SOAP mogą uzyskać zamierzonego adresata, pobierając Role właściwości lub Actor .

Adresaci elementu Body i każdy nagłówek PROTOKOŁU SOAP w Header elemendacie komunikatu PROTOKOŁU SOAP nie musi być taki sam. 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 actor , zobacz specyfikację protokołu SOAP .