SoapHeader.Actor-Eigenschaft

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

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property Actor As String
'Usage
Dim instance As SoapHeader
Dim value As String

value = instance.Actor

instance.Actor = value

public string Actor { get; set; }

public:
property String^ Actor {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Actor ()

/** @property */
public void set_Actor (String value)

public function get Actor () : String

public function set Actor (value : String)

Eigenschaftenwert

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

Hinweise

Legen Sie zum Festlegen des Empfängers eines SOAP-Headers die Actor-Eigenschaft fest. Unabhängig von der Version des für die Kommunikation mit einem XML-Webdienst verwendeten SOAP-Protokolls generiert .NET Framework automatisch die SOAP-Nachricht, die nur bei der Version des SOAP-Protokolls vorhanden ist. Das XML-Element und der den Empfänger darstellenden XML-Namespace sind für die zwei Versionen unterschiedlich.

XML-Webdienste, die den SOAP-Header empfangen, können den gewünschten Empfänger durch Abrufen der Role-Eigenschaft oder der Actor-Eigenschaft abrufen.

Der/Die Empfänger für das Body-Element und die SOAP-Header im Header-Element einer SOAP-Nachricht müssen nicht gleich sein. Wenn in der SOAP-Nachricht ein Header-Element vorhanden ist, stellt dieses zusätzliche Daten dar, die an die XML-Webdienstmethode oder einen Vermittler gesendet und von dieser/diesem empfangen werden können. Beim Empfänger dieser Daten, der in Version 1.1 als SOAP-Actor bezeichnet wird, kann es sich um einen anderen URI als den URI für die XML-Webdienstmethode handeln.

Weitere Informationen zum actor-Attribut von SOAP finden Sie in der SOAP-Spezifikation unter http://www.w3.org/TR/SOAP.

Beispiel

Durch den folgenden XML-Webdienstclient wird die MyWebMethod-XML-Webdienstmethode nach dem Erstellen eines benutzerdefinierten SOAP-Headers vom Typ MyHeader und dem Festlegen der Actor-Eigenschaft auf https://www.contoso.com/MySoapHeaderHandler aufgerufen.

Imports System

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 = "https://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

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 = "https://www.contoso.com/MySoapHeaderHandler";
            ws.myHeader = customHeader;
            
        int results = ws.MyWebMethod(3,5);
        }
        catch (Exception e) {
            Console.WriteLine ("Exception: {0}", e.ToString());
        }
    }
}

int main()
{
   MyWebService^ ws = gcnew MyWebService;
   try
   {
      MyHeader^ customHeader = gcnew MyHeader;
      customHeader->MyValue = "Header Value for MyValue";
      customHeader->Actor = "https://www.contoso.com/MySoapHeaderHandler";
      ws->myHeader = customHeader;
      int results = ws->MyWebMethod( 3, 5 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e );
   }

}

import System.*;

public class Sample
{
    public static void main(String[] args)
    {
        MyWebService ws = new MyWebService();

        try {
            MyHeader customHeader = new MyHeader();
            customHeader.myValue = "Header Value for MyValue";
            customHeader.set_Actor(
                                "https://www.contoso.com/MySoapHeaderHandler");
            ws.myHeader = customHeader;
            int results = ws.MyWebMethod(3, 5);
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception: {0}", e.ToString());
        }
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapHeader-Klasse
SoapHeader-Member
System.Web.Services.Protocols-Namespace