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 标头并将属性http://www.contoso.com/MySoapHeaderHandler设置为 Actor 后调用 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 服务可以通过获取 Role 或 Actor 属性来获取预期收件人。

接收方 (元素和 SOAP 消息元素中的每个 Header SOAP 标头) Body不需要相同。 Header如果 SOAP 消息中存在元素，则表示可以发送到 XML Web 服务方法或中介的其他数据。 该数据的接收方（称为版本 1.1 中的 SOAP Actor ）可以不同于 XML Web 服务方法的 URI。

有关 SOAP actor 属性的详细信息，请参阅 SOAP 规范。