SoapHeaderAttribute(String) Constructeur

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Initialise une nouvelle instance de la classe SoapHeaderAttribute, définissant le membre de la classe du service Web XML représentant le contenu de l'en-tête SOAP.

public:
 SoapHeaderAttribute(System::String ^ memberName);

public SoapHeaderAttribute (string memberName);

new System.Web.Services.Protocols.SoapHeaderAttribute : string -> System.Web.Services.Protocols.SoapHeaderAttribute

Public Sub New (memberName As String)

Paramètres

memberName

String

Membre de la classe de service Web XML représentant le contenu de l'en-tête SOAP. La propriété MemberName prend la valeur de ce paramètre.

Exemples

Le service Web XML suivant MyWebService définit un SoapHeader de type MyHeader. La Hello méthode de service Web XML spécifie le myHeader membre comme MemberName propriété pour recevoir le contenu des MyHeader en-têtes SOAP passés à la méthode de service Web XML.

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Web::Services;
using namespace System::Web::Services::Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public ref class MyHeader: public SoapHeader
{
public:
   String^ MyValue;
};

public ref class MyWebService
{
public:

   // Member variable to receive the contents of the MyHeader SOAP header.
   MyHeader^ myHeader;

   [WebMethod]
   [SoapHeader("myHeader",Direction=SoapHeaderDirection::InOut)]
   void Hello(){}

};

using System;
using System.Web.Services;
using System.Web.Services.Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {
    // Member variable to receive the contents of the MyHeader SOAP header.
    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]
    public void Hello() {
    }
}

Imports System.Web.Services
Imports System.Web.Services.Protocols

' Define a SOAP header by deriving from the SoapHeader base class.
' The header contains just one string value.
Public Class MyHeader
   Inherits SoapHeader
   Public MyValue As String
End Class


Public Class MyWebService
   ' Member variable to receive the contents of the MyHeader SOAP header.
   Public myHeader As MyHeader

   
   <WebMethod, _ 
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut)> _
   Public Sub Hello()

   End Sub
End Class

Remarques

Un client de service Web XML ou un service Web XML peut spécifier les en-têtes SOAP qu’il souhaite traiter pour des méthodes de service Web XML spécifiques en appliquant un SoapHeaderAttribute à la méthode de service Web XML dans la classe de service Web XML ou à la méthode correspondante dans la classe proxy. Pour que la méthode de service Web XML reçoive le contenu de l’en-tête SOAP, un membre est ajouté à la classe de service Web XML d’un Type dérivé de SoapHeader. De même, un client de service Web XML ajoute un membre à la classe proxy dérivant de SoapHeader. Cette Type dérivée de SoapHeader représente le contenu de l’en-tête SOAP et est créée par le développeur du service Web XML ou du client de service Web XML qui souhaite recevoir l’en-tête SOAP. Une fois la classe créée, un SoapHeaderAttribute peut être appliqué à la méthode de service Web XML ou à la méthode correspondante dans la classe proxy du service Web XML en spécifiant le membre à recevoir le contenu de l’en-tête SOAP avec le memberName paramètre pour ce constructeur ou la MemberName propriété .

Une méthode de service Web XML peut recevoir plusieurs en-têtes SOAP en ajoutant plusieurs membres à la classe de service Web XML ou à la classe proxy du service Web XML, puis en appliquant plusieurs SoapHeaderAttribute attributs à la méthode de service Web XML.

Pour recevoir et traiter des en-têtes SOAP inconnus au moment de l’écriture du service Web XML, spécifiez le Type du membre comme étant SoapUnknownHeader, SoapHeader ou un tableau de l’une ou l’autre classe.