SoapHeaderAttribute(String) Constructeur

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Initialise une nouvelle instance de la SoapHeaderAttribute classe, en définissant le membre de la classe de 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 MemberName propriété est définie sur la valeur de ce paramètre.

Exemples

Le service web XML suivant MyWebService définit l’un SoapHeader des types 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 dans 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 une SoapHeaderAttribute méthode au 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érivation 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, une SoapHeaderAttribute méthode peut être appliquée à la méthode de service Web XML ou à la méthode correspondante dans la classe proxy du client du service web XML spécifiant le membre pour recevoir le contenu de l’en-tête SOAP avec le memberName paramètre de 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 de service web XML et en appliquant à son tour 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 membre à utiliser SoapUnknownHeaderou SoapHeader un tableau d’une classe.