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

Nom Valeur Description
BeforeSerialize 1

Étape juste avant d’être SoapMessage sérialisée.
AfterSerialize 2

L’étape juste après une SoapMessage sérialisation, mais avant que le message SOAP ne soit envoyé sur le fil.
BeforeDeserialize 4

L’étape juste avant qu’un SoapMessage message SOAP soit désérialisé à partir du message SOAP envoyé sur le réseau dans un objet.
AfterDeserialize 8

L’étape juste après la SoapMessage désérialisation d’un message SOAP dans un objet.

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 est SoapMessage géré spécifique à l’objet 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 message 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 client et serveur 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 une requête réseau contenant un message SOAP représentant un appel de méthode de service Web XML désérialisé dans un objet, mais avant la méthode de cet objet représentant la méthode du service Web XML est appelée.
AfterSerialize Se produit après qu’un client appelle une méthode de service Web XML et que les paramètres sont sérialisés en XML, mais avant le message SOAP contenant ce code XML est envoyé sur le réseau. Se produit après qu’une méthode de service Web XML retourne et que toutes les valeurs de retour sont sérialisées en XML, mais avant le message SOAP contenant ce xml est envoyé sur le réseau.
BeforeDeserialize Se produit une fois que la réponse réseau d’un appel de méthode de service Web XML a été reçue, mais juste avant que la réponse contenant le message SOAP soit désérialisée dans un objet. Se produit après qu’une demande réseau contenant le message SOAP pour un appel de méthode de service Web XML est reçue par le serveur Web, mais avant que le message SOAP soit désérialisé 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 l’appel à la méthode de service Web XML retournée, mais avant que les valeurs de retour soient sérialisées et envoyées via le câble au client.

S’applique à

Voir aussi