SoapHeader.Actor Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit le destinataire de l'en-tête 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

Valeur de propriété

String

Destinataire de l'en-tête SOAP. La valeur par défaut est une chaîne vide ("").

Exemples

Le client de service web XML suivant appelle la MyWebMethod méthode de service Web XML après avoir créé un en-tête SOAP personnalisé de type MyHeader et défini la Actor propriété sur 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

Remarques

Pour définir le destinataire d’un en-tête SOAP, définissez la Actor propriété. Quelle que soit la version du protocole SOAP utilisé pour communiquer avec un service Web XML, le .NET Framework génère automatiquement le message SOAP spécifique à la version du protocole SOAP. Plus précisément, l’élément XML et l’espace de noms XML représentant le destinataire diffèrent pour les deux versions.

Les services Web XML qui reçoivent l’en-tête SOAP peuvent obtenir le destinataire prévu en obtenant les propriétés ou Actor les Role propriétés.

Le ou les destinataires de l’élément Body et chacun des en-têtes SOAP au sein de l’élément Header d’un message SOAP n’a pas besoin d’être identique. Si un Header élément existe dans le message SOAP, il représente des données supplémentaires qui peuvent être envoyées à et à partir de la méthode de service Web XML ou d’un intermédiaire. Le destinataire de ces données, appelé SOAP Actor dans la version 1.1, peut être un URI différent de l’URI de la méthode de service web XML.

Pour plus d’informations sur l’attribut SOAP actor , consultez la spécification SOAP .