SoapMessageStage Enumerazione

Definizione

Spazio dei nomi:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Specifica la fase di elaborazione di un messaggio SOAP.

public enum class SoapMessageStage

public enum SoapMessageStage

type SoapMessageStage = 

Public Enum SoapMessageStage

Ereditarietà

Object

ValueType

Enum

SoapMessageStage

Campi

AfterDeserialize	8	La fase successiva a un oggetto SoapMessage viene deserializzata da un messaggio SOAP in un oggetto.
AfterSerialize	2	Fase che segue la serializzazione di un oggetto SoapMessage ma che precede l'invio in rete del messaggio SOAP.
BeforeDeserialize	4	La fase precedente un oggetto SoapMessage viene deserializzata da un messaggio SOAP inviato in rete in un oggetto.
BeforeSerialize	1	Fase che precede la serializzazione di un oggetto SoapMessage.

Esempio

L'esempio seguente è un frammento di un'estensione SOAP, che implementa il ProcessMessage metodo . All'interno del ProcessMessage metodo l'elaborazione di un SoapMessage oggetto viene gestita specificamente per .SoapMessageStage

// Process the SOAP message received and write to log file.
void ProcessMessage( SoapMessage^ message )
{
   switch ( message->Stage )
   {
      case SoapMessageStage::BeforeSerialize:
         break;
      case SoapMessageStage::AfterSerialize:
         WriteOutput( message );
         break;
      case SoapMessageStage::BeforeDeserialize:
         WriteInput( message );
         break;
      case SoapMessageStage::AfterDeserialize:
         break;
      default:
         throw gcnew Exception( "invalid stage" );
   }
}

// Process the SOAP message received and write to log file.
public override void ProcessMessage(SoapMessage message)
{
   switch (message.Stage)
   {
      case SoapMessageStage.BeforeSerialize:
         break;
      case SoapMessageStage.AfterSerialize:
         WriteOutput( message );
         break;
      case SoapMessageStage.BeforeDeserialize:
         WriteInput( message );
         break;
      case SoapMessageStage.AfterDeserialize:
         break;
      default:
         throw new Exception("invalid stage");
   }
}

  ' Process the SOAP message received and write to log file.
  Public Overrides Sub ProcessMessage(message As SoapMessage)
     Select Case message.Stage
        Case SoapMessageStage.BeforeSerialize
        Case SoapMessageStage.AfterSerialize
           WriteOutput(message)
        Case SoapMessageStage.BeforeDeserialize
           WriteInput(message)
        Case SoapMessageStage.AfterDeserialize
        Case Else
              Throw New Exception("invalid stage")
     End Select
End Sub

Commenti

ASP.NET fornisce un meccanismo di estendibilità per chiamare servizi Web tramite SOAP. Il meccanismo di estendibilità ruota attorno a un SoapExtension oggetto che può controllare o modificare un messaggio in fasi specifiche nell'elaborazione dei messaggi nel client o nel server. Questa enumerazione specifica la fase di elaborazione di SoapMessage.

La tabella seguente mostra quando ogni fase si verifica durante l'elaborazione del client SOAP e del server.

SoapMessageStage	Durante SoapClientMessage l'elaborazione	Durante SoapServerMessage l'elaborazione
AfterDeserialize	Si verifica dopo che il messaggio SOAP contenente la risposta da una chiamata al metodo di servizio Web XML è stata deserializzata in un oggetto, ma prima del client che riceve i risultati deserializzati.	Si verifica dopo una richiesta di rete contenente un messaggio SOAP che rappresenta una chiamata al metodo del servizio Web XML viene deserializzata in un oggetto, ma prima del metodo su tale oggetto che rappresenta il metodo del servizio Web XML viene chiamato.
AfterSerialize	Si verifica dopo che un client richiama un metodo di servizio Web XML e i parametri vengono serializzati in XML, ma prima del messaggio SOAP contenente il codice XML viene inviato tramite la rete.	Si verifica dopo che un metodo di servizio Web XML restituisce e tutti i valori restituiti vengono serializzati in XML, ma prima del messaggio SOAP contenente tale xml viene inviato sulla rete.
BeforeDeserialize	Si verifica dopo la ricezione della risposta di rete da una chiamata al metodo di servizio Web XML, ma appena prima della risposta contenente il messaggio SOAP viene deserializzata in un oggetto.	Si verifica dopo una richiesta di rete contenente il messaggio SOAP per una chiamata al metodo del servizio Web XML viene ricevuta dal server Web, ma prima del messaggio SOAP deserializzato in un oggetto.
BeforeSerialize	Si verifica dopo che un client richiama un metodo di servizio Web XML, ma prima della serializzazione della chiamata.	Si verifica dopo che la chiamata al metodo del servizio Web XML restituisce, ma prima della serializzazione dei valori restituiti e inviata tramite il collegamento al client.

Vedi anche

• SoapMessage
• SoapExtension