SoapHeaderAttribute.MemberName Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit le membre de la classe de service Web XML représentant le contenu de l'en-tête SOAP.

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

public string MemberName { get; set; }

member this.MemberName : string with get, set

Public Property MemberName As String

Valeur de propriété

String

Membre de la classe de service Web XML représentant le contenu de l'en-tête SOAP. Il n'y a pas de valeur par défaut.

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 transmis à 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 service Web XML ou un client de service Web XML peut spécifier les en-têtes SOAP qu’il souhaite traiter 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. Le Type dérivant de SoapHeader représente le contenu de l’en-tête SOAP et est créé 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 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 du membre à être SoapUnknownHeader, SoapHeader ou un tableau de l’une ou l’autre classe.