SoapMessageStage Enumeration
Specifies the processing stage of a SOAP message.
Assembly: System.Web.Services (in System.Web.Services.dll)
| Member name | Description | |
|---|---|---|
| AfterDeserialize | The stage just after a SoapMessage is deserialized from a SOAP message into an object. | |
| AfterSerialize | The stage just after a SoapMessage is serialized, but before the SOAP message is sent over the wire. | |
| BeforeDeserialize | The stage just before a SoapMessage is deserialized from the SOAP message sent across the network into an object. | |
| BeforeSerialize | The stage just prior to a SoapMessage being serialized. |
ASP.NET provides an extensibility mechanism for calling Web Services using SOAP. 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. This enumeration specifies the processing stage of the SoapMessage.
The following code example is a fragment of a SOAP extension, which implements the ProcessMessage method. Within the ProcessMessage method, processing of a SoapMessage is handled specific to the SoapMessageStage.
' 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 'ProcessMessage
Available since 1.1