SoapHeader.Actor 屬性

定義

命名空間:

System.Web.Services.Protocols

組件:

System.Web.Services.dll

取得或設定 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

屬性值

String

SOAP 標頭的收件者。 預設為空字串 ("")。

範例

下列 XML Web 服務用戶端會在建立 型 MyHeader 別的自訂 SOAP 標頭並將 屬性設定 Actor 為 http://www.contoso.com/MySoapHeaderHandler 之後呼叫 MyWebMethod XML Web 服務方法。

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

備註

若要設定 SOAP 標頭的收件者，請設定 Actor 屬性。 不論用來與 XML Web 服務通訊的 SOAP 通訊協定版本為何，.NET Framework會自動產生 SOAP 通訊協定版本特定的 SOAP 訊息。 具體來說，代表收件者的 XML 元素和 XML 命名空間對於兩個版本不同。

接收 SOAP 標頭的 XML Web 服務可以藉由取得 或 Actor 屬性來取得 Role 預定的收件者。

收件者 (元素的) Body ，而 SOAP 訊息元素內的 Header 每個 SOAP 標頭都不需要相同。 Header如果專案存在於 SOAP 訊息中，它代表可以傳送至 XML Web 服務方法或媒介的其他資料。 該資料收件者在 1.1 版中稱為 SOAP Actor ，可以是與 XML Web 服務方法 URI 不同的 URI。

如需 SOAP actor 屬性的詳細資訊，請參閱 SOAP 規格。