SoapHeaderAttribute(String) Costruttore

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Inizializza una nuova istanza della classe SoapHeaderAttribute, impostando il membro della classe di servizi Web XML che rappresenta il contenuto dell'intestazione 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)

Parametri

memberName

String

Membro della classe di servizi Web XML che rappresenta il contenuto dell'intestazione SOAP. La proprietà MemberName verrà impostata sul valore di questo parametro.

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 client di servizio Web XML o un servizio Web XML può specificare le intestazioni SOAP che desidera elaborare per metodi specifici del servizio Web XML applicando un SoapHeaderAttribute al metodo del servizio Web XML nella classe del servizio Web XML o il metodo corrispondente nella classe proxy. Affinché il metodo del servizio Web XML riceva il contenuto dell'intestazione SOAP, un membro viene aggiunto alla classe del servizio Web XML di un Type derivato da SoapHeader. Analogamente, un client del servizio Web XML aggiunge un membro alla classe proxy derivata da SoapHeader. Che Type deriva da SoapHeader rappresenta il contenuto dell'intestazione SOAP e viene creato 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 il memberName parametro per questo costruttore o 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 l'oggetto Type del membro come SoapUnknownHeadero SoapHeader una matrice di una delle due classi.