SoapHeader.Actor Eigenschaft

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ruft den Empfänger des SOAP-Headers ab oder legt diesen fest.

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

Eigenschaftswert

String

Der Empfänger des SOAP-Headers. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Der folgende XML-Webdienstclient ruft die MyWebMethod XML-Webdienstmethode auf, nachdem er einen benutzerdefinierten SOAP-Header vom Typ MyHeader erstellt und die Actor -Eigenschaft auf festgelegt hat 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

Hinweise

Um den Empfänger eines SOAP-Headers festzulegen, legen Sie die Actor -Eigenschaft fest. Unabhängig von der Version des SOAP-Protokolls, das für die Kommunikation mit einem XML-Webdienst verwendet wird, generiert der .NET Framework automatisch die SOAP-Nachricht, die für die Version des SOAP-Protokolls spezifisch ist. Insbesondere unterscheiden sich das XML-Element und der XML-Namespace, der den Empfänger darstellt, in den beiden Versionen.

XML-Webdienste, die den SOAP-Header empfangen, können den beabsichtigten Empfänger abrufen, indem sie entweder die Role Eigenschaften oder Actor abrufen.

Die Empfänger für das Body Element und die einzelnen SOAP-Header innerhalb des Header Elements einer SOAP-Nachricht müssen nicht identisch sein. Wenn ein Header Element in der SOAP-Nachricht vorhanden ist, stellt es zusätzliche Daten dar, die an und von der XML-Webdienstmethode oder einem Vermittler gesendet werden können. Der Empfänger dieser Daten, der in Version 1.1 als SOAP Actor bezeichnet wird, kann ein anderer URI als der URI für die XML-Webdienstmethode sein.

Weitere Informationen zum SOAP-Attribut actor finden Sie in der SOAP-Spezifikation .