SoapHeaderAttribute.MemberName Proprietà

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ottiene o imposta il membro della classe di servizi Web XML che rappresenta il contenuto dell'intestazione 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

Valore della proprietà

String

Membro della classe di servizi Web XML che rappresenta il contenuto dell'intestazione SOAP. Non prevede alcun valore predefinito.

Esempio

Il servizio Web XML seguente MyWebService definisce uno SoapHeader di tipo MyHeader. Il Hello metodo del servizio Web XML specifica il myHeader membro come MemberName proprietà per ricevere il contenuto delle MyHeader intestazioni SOAP passate al metodo del servizio 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

Commenti

Un servizio Web XML o un client del servizio Web XML può specificare le intestazioni SOAP che desidera elaborare applicando un SoapHeaderAttribute oggetto al metodo del servizio Web XML nella classe del servizio Web XML o nel metodo corrispondente nella classe proxy. Affinché il metodo del servizio Web XML riceva il contenuto dell'intestazione SOAP, un membro viene aggiunto alla classe di servizio Web XML di un tipo derivato da SoapHeader. Analogamente, un client del servizio Web XML aggiunge un membro alla classe proxy derivata da SoapHeader. La Type derivazione da SoapHeader rappresenta il contenuto dell'intestazione SOAP e viene creata dallo sviluppatore del client del servizio Web XML o del servizio Web XML che desidera ricevere l'intestazione SOAP. Dopo aver creato la classe, è possibile applicare un SoapHeaderAttribute oggetto al metodo del servizio Web XML o al metodo corrispondente nella classe proxy del client del servizio Web XML che specifica il membro per ricevere il contenuto dell'intestazione SOAP con la MemberName proprietà .

Un metodo di servizio Web XML può ricevere più intestazioni SOAP aggiungendo più membri alla classe del servizio Web XML o alla classe proxy del servizio Web XML e a sua volta applicando più SoapHeaderAttribute attributi al metodo del servizio Web XML.

Per ricevere ed elaborare intestazioni SOAP sconosciute al momento della scrittura del servizio Web XML, specificare il tipo del membro come SoapUnknownHeadero SoapHeader una matrice di una delle due classi.