SoapHeader.Actor Eigenschaft

Referenz

Definition

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 .

Gilt für:

Freigeben über