SoapHeader.Actor Properti

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Mendapatkan atau mengatur penerima header 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

Nilai Properti

String

Penerima header SOAP. Defaultnya adalah string kosong ("").

Contoh

Klien layanan Web XML berikut memanggil MyWebMethod metode layanan Web XML setelah membuat header SOAP kustom jenis MyHeader dan mengatur Actor properti ke 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

Keterangan

Untuk mengatur penerima header SOAP, atur Actor properti . Terlepas dari versi protokol SOAP yang digunakan untuk berkomunikasi dengan layanan Web XML, .NET Framework secara otomatis menghasilkan pesan SOAP khusus untuk versi protokol SOAP. Secara khusus, elemen XML dan namespace XML yang mewakili penerima berbeda untuk dua versi.

Layanan Web XML yang menerima header SOAP bisa mendapatkan penerima yang dimaksudkan dengan mendapatkan Role properti atau Actor .

Penerima untuk Body elemen dan setiap header SOAP dalam Header elemen pesan SOAP tidak perlu sama. Header Jika ada elemen dalam pesan SOAP, elemen tersebut mewakili data tambahan yang dapat dikirim ke dan dari metode layanan Web XML atau perantara. Penerima data tersebut, yang dikenal sebagai SOAP Actor dalam versi 1.1, dapat menjadi URI yang berbeda dari URI untuk metode layanan Web XML.

Untuk informasi selengkapnya tentang atribut SOAP actor , lihat spesifikasi SOAP .