This documentation is archived and is not being maintained.

SoapMessage.Stage Property

Gets the SoapMessageStage of the SoapMessage.

[Visual Basic]
Public ReadOnly Property Stage As SoapMessageStage
[C#]
public SoapMessageStage Stage {get;}
[C++]
public: __property SoapMessageStage get_Stage();
[JScript]
public function get Stage() : SoapMessageStage;

Property Value

The SoapMessageStage of the SoapMessage.

Remarks

The Stage property can be accessed at any SoapMessageStage.

Example

[Visual Basic, C#, C++] The following code example demonstrates how to determine the SoapMessageStage within the SoapExtension.ProcessMessage method.

[Visual Basic] 
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    


[C#] 
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");
        }
}


[C++] 
public:
    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(S"invalid stage");
        }
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

SoapMessage Class | SoapMessage Members | System.Web.Services.Protocols Namespace

Show: