This documentation is archived and is not being maintained.

SoapMessage::EnsureStage Method

Ensures that the SoapMessageStage of the call to the XML Web service method is the stage or stages passed in. If the current processing stage is not one of the stages passed in, an exception is thrown.

Namespace:  System.Web.Services.Protocols
Assembly:  System.Web.Services (in System.Web.Services.dll)

protected:
void EnsureStage(
	SoapMessageStage stage
)

ExceptionCondition
InvalidOperationException

The current SoapMessageStage is not the asserted stage or stages.

Multiple stages can be asserted by performing a bitwise OR operation on multiple instances of the SoapMessageStage class.

EnsureStage can be called during any SoapMessageStage.

The following example asserts that the current SoapMessageStage is either BeforeSerialize or BeforeDeserialize; if it is not, an exception is thrown.

EnsureStage( (SoapMessageStage)( SoapMessageStage::BeforeSerialize |
   SoapMessageStage::BeforeDeserialize ) );
EnsureStage(static_cast<SoapMessageStage>(SoapMessageStage::BeforeSerialize | SoapMessageStage::BeforeDeserialize));

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0
Show: