SoapMessageStage Enumeration

Definition

Gibt die Verarbeitungsstufe einer SOAP-Nachricht an.Specifies the processing stage of a SOAP message.

public enum class SoapMessageStage
public enum SoapMessageStage
type SoapMessageStage = 
Public Enum SoapMessageStage
Vererbung
SoapMessageStage

Felder

AfterDeserialize 8

Die Stufe nach der Deserialisierung einer SoapMessage aus einer SOAP-Nachricht in ein Objekt.The stage just after a SoapMessage is deserialized from a SOAP message into an object.

AfterSerialize 2

Die Stufe nach dem Serialisieren einer SoapMessage und vor dem Senden der SOAP-Nachricht über die Verbindung.The stage just after a SoapMessage is serialized, but before the SOAP message is sent over the wire.

BeforeDeserialize 4

Die Stufe vor der Deserialisierung einer SoapMessage aus der über das Netzwerk gesendeten SOAP-Nachricht in ein Objekt.The stage just before a SoapMessage is deserialized from the SOAP message sent across the network into an object.

BeforeSerialize 1

Die Stufe vor dem Serialisieren einer SoapMessage.The stage just prior to a SoapMessage being serialized.

Beispiele

Das folgende Beispiel ist ein Fragment einer SOAP-Erweiterung, die die ProcessMessage -Methode implementiert.The following example is a fragment of a SOAP extension, which implements the ProcessMessage method. Innerhalb der ProcessMessage -Methode SoapMessage wird die Verarbeitung eines speziell für die SoapMessageStagebehandelt.Within the ProcessMessage method, processing of a SoapMessage is handled specific to the 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

Hinweise

ASP.net bietet einen Erweiterbarkeits Mechanismus zum Aufrufen von Webdiensten mithilfe von SOAP.ASP.NET provides an extensibility mechanism for calling Web Services using SOAP. Der Erweiterbarkeits Mechanismus dreht sich um einen SoapExtension , der eine Nachricht in bestimmten Phasen der Nachrichtenverarbeitung auf dem Client oder auf dem Server überprüfen oder ändern kann.The extensibility mechanism revolves around a SoapExtension that can inspect or modify a message at specific stages in message processing on either the client or the server. Diese Enumeration gibt die Verarbeitungsphase des an SoapMessage.This enumeration specifies the processing stage of the SoapMessage.

In der folgenden Tabelle wird dargestellt, wann jede Phase während der SOAP-Client-und Server Verarbeitung stattfindet.The following table shows when each stage occurs during SOAP client and server processing.

SoapMessageStage Während SoapClientMessage der VerarbeitungDuring SoapClientMessage processing Während SoapServerMessage der VerarbeitungDuring SoapServerMessage processing
AfterDeserialize Tritt auf, nachdem die SOAP-Nachricht, die die Antwort von einem XML-Webdienst Methodenaufruf enthält, in ein Objekt deserialisiert wurde, jedoch bevor der Client die deserialisierten Ergebnisse empfangen hat.Occurs after the SOAP message containing the response from an XML Web service method invocation has been deserialized into an object, but prior to the client receiving the deserialized results. Tritt auf, nachdem eine Netzwerk Anforderung mit einer SOAP-Nachricht, die einen XML-Webdienst Methodenaufruf darstellt, in ein-Objekt deserialisiert wird, aber bevor die-Methode für dieses Objekt, das die XML-Webdienst Methode darstellt, aufgerufen wird.Occurs after a network request containing a SOAP message representing an XML Web service method invocation is deserialized into an object, but prior to the method on that object representing the XML Web service method is called.
AfterSerialize Tritt auf, nachdem ein Client eine XML-Webdienst Methode aufgerufen hat und die Parameter in XML serialisiert werden, aber bevor die SOAP-Nachricht, in der diese XML-Nachricht enthalten ist, über das Netzwerk gesendet wird.Occurs after a client invokes an XML Web service method and the parameters are serialized into XML, but prior to the SOAP message containing that XML is sent over the network. Tritt auf, nachdem eine XML-Webdienst Methode zurückgegeben und alle Rückgabewerte in XML serialisiert wurden, aber bevor die SOAP-Nachricht, die diese XML-Nachricht enthält, über das Netzwerk gesendet wird.Occurs after an XML Web service method returns and any return values are serialized into XML, but prior to the SOAP message containing that XML is sent over the network.
BeforeDeserialize Tritt auf, nachdem die Netzwerk Antwort von einem XML-Webdienst Methodenaufruf empfangen wurde, aber kurz bevor die Antwort, die die SOAP-Nachricht enthält, in ein-Objekt deserialisiert wird.Occurs after the network response from an XML Web service method invocation has been received, but just before the response containing the SOAP message is deserialized into an object. Tritt auf, nachdem eine Netzwerk Anforderung mit der SOAP-Nachricht für einen Aufruf der XML-Webdienst Methode vom Webserver empfangen wurde, jedoch bevor die SOAP-Nachricht in ein Objekt deserialisiert wurde.Occurs after a network request containing the SOAP message for an XML Web service method invocation is received by the Web server, but prior to the SOAP message being deserialized into an object.
BeforeSerialize Tritt auf, nachdem ein Client eine XML-Webdienst Methode aufgerufen hat, jedoch bevor der Aufruf serialisiert wurde.Occurs after a client invokes an XML Web service method, but prior to the invocation being serialized. Tritt auf, nachdem der Aufruf der XML-Webdienst Methode zurückgegeben wurde, jedoch vor den Rückgabe Werten, die serialisiert und über das Netzwerk zurück an den Client gesendet werden.Occurs after the invocation to the XML Web service method returns, but prior to the return values being serialized and sent over the wire back to the client.

Gilt für:

Siehe auch