SoapHeader.Actor Vlastnost

Definice

Obor názvů:

System.Web.Services.Protocols

Sestavení:

System.Web.Services.dll

Získá nebo nastaví příjemce hlavičky 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

Hodnota vlastnosti

String

Příjemce hlavičky SOAP. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující klient webové služby XML volá metodu MyWebMethod webové služby XML po vytvoření vlastní hlavičky SOAP typu MyHeader a nastavení Actor vlastnosti 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

Poznámky

Pokud chcete nastavit příjemce hlavičky SOAP, nastavte Actor vlastnost . Bez ohledu na verzi protokolu SOAP, která se používá ke komunikaci s webovou službou XML, rozhraní .NET Framework automaticky vygeneruje zprávu SOAP specifickou pro verzi protokolu SOAP. Konkrétně se u těchto dvou verzí liší element XML a obor názvů XML představující příjemce.

Webové služby XML, které přijímají hlavičku SOAP, můžou získat požadovaného příjemce získáním vlastností nebo RoleActor .

Příjemci elementu Body a každé hlavičky SOAP v elementu Header zprávy SOAP nemusí být stejné. Header Pokud ve zprávě SOAP existuje prvek, představuje další data, která lze odeslat do a z metody webové služby XML nebo zprostředkující. Příjemcem těchto dat, označovaným jako SOAP Actor ve verzi 1.1, může být jiný identifikátor URI než identifikátor URI pro metodu webové služby XML.

Další informace o atributu SOAP actor najdete ve specifikaci SOAP .