SoapHeader.Actor Özellik

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

SOAP üst bilgisinin alıcısını alır veya ayarlar.

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

Özellik Değeri

String

SOAP üst bilgisinin alıcısı. Varsayılan değer, boş dizedir ("").

Örnekler

Aşağıdaki XML Web hizmeti istemcisi, türünde MyHeader özel bir SOAP üst bilgisi oluşturduktan ve özelliğini http://www.contoso.com/MySoapHeaderHandlerolarak ayarladıktan Actor sonra XML Web hizmeti yöntemini çağırırMyWebMethod.

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

Açıklamalar

SOAP üst bilgisinin alıcısını ayarlamak için özelliğini ayarlayın Actor . BIR XML Web hizmetiyle iletişim kurmak için kullanılan SOAP protokolünün sürümünden bağımsız olarak, .NET Framework SOAP protokolünün sürümüne özgü SOAP iletisini otomatik olarak oluşturur. Özellikle, alıcıyı temsil eden XML öğesi ve XML ad alanı iki sürüm için farklılık gösterir.

SOAP üst bilgisini alan XML Web hizmetleri, veya Actor özelliklerini alarak hedeflenen alıcıyı Role alabilir.

Öğenin alıcıları Body ve soap iletisinin öğesi içindeki Header SOAP üst bilgilerinin her biri aynı olmamalıdır. SOAP iletisinde bir Header öğe varsa, XML Web hizmeti yöntemine veya aracıya gönderilebilen ek verileri temsil eder. Sürüm 1.1'de SOAP Actor olarak bilinen bu verilerin alıcısı, XML Web hizmeti yönteminin URI'sinden farklı bir URI olabilir.

SOAP actor özniteliği hakkında daha fazla bilgi için bkz. SOAP belirtimi.