SoapMessageStage Énumération

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Spécifie l'étape de traitement d'un message SOAP.

public enum class SoapMessageStage

public enum SoapMessageStage

type SoapMessageStage = 

Public Enum SoapMessageStage

Héritage

Object

ValueType

Enum

SoapMessageStage

Champs

AfterDeserialize	8	L'étape juste après SoapMessage est désérialisée en un objet à partir d'un message SOAP.
AfterSerialize	2	L'étape juste après SoapMessage est sérialisée, mais avant que le message SOAP ne soit envoyé sur le réseau.
BeforeDeserialize	4	L'étape suivant immédiatement SoapMessage est désérialisée en un objet à partir du message SOAP envoyé sur le réseau.
BeforeSerialize	1	L'étape juste avant la sérialisation de SoapMessage.

Exemples

L’exemple suivant est un fragment d’une extension SOAP, qui implémente la ProcessMessage méthode . Dans la méthode , le ProcessMessage traitement d’un SoapMessage est géré spécifique à .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

Remarques

ASP.NET fournit un mécanisme d’extensibilité pour appeler des services web à l’aide de SOAP. Le mécanisme d’extensibilité tourne autour d’un SoapExtension qui peut inspecter ou modifier un message à des étapes spécifiques du traitement des messages sur le client ou le serveur. Cette énumération spécifie l’étape de traitement du SoapMessage.

Le tableau suivant indique quand chaque étape se produit pendant le traitement du serveur et du client SOAP.

SoapMessageStage	Pendant le SoapClientMessage traitement	Pendant le SoapServerMessage traitement
AfterDeserialize	Se produit après que le message SOAP contenant la réponse d’un appel de méthode de service Web XML a été désérialisé dans un objet, mais avant que le client ne reçoive les résultats désérialisés.	Se produit après qu’une requête réseau contenant un message SOAP représentant un appel de méthode de service Web XML est désérialisée dans un objet, mais avant l’appel de la méthode sur cet objet représentant la méthode de service Web XML est appelée.
AfterSerialize	Se produit après qu’un client a appelé une méthode de service Web XML et que les paramètres sont sérialisés en XML, mais avant que le message SOAP contenant ce xml soit envoyé sur le réseau.	Se produit après le retour d’une méthode de service Web XML et la sérialisation de toutes les valeurs de retour en XML, mais avant le message SOAP contenant ce xml est envoyé sur le réseau.
BeforeDeserialize	Se produit après la réception de la réponse réseau d’un appel de méthode de service Web XML, mais juste avant que la réponse contenant le message SOAP ne soit désérialisée dans un objet .	Se produit après la réception par le serveur Web d’une demande réseau contenant le message SOAP pour un appel de méthode de service Web XML, mais avant la désérialisation du message SOAP dans un objet .
BeforeSerialize	Se produit après qu’un client appelle une méthode de service Web XML, mais avant la sérialisation de l’appel.	Se produit après le retour de l’appel à la méthode de service Web XML, mais avant que les valeurs de retour ne soient sérialisées et renvoyées au client via le réseau.

Voir aussi

• SoapMessage
• SoapExtension