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
)
protected void EnsureStage (
	SoapMessageStage stage
)
protected function EnsureStage (
	stage : SoapMessageStage
)
Not applicable.

Parameters

stage

The SoapMessageStage asserted.

Exception typeCondition

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(new SoapMessageStage(SoapMessageStage.beforeSerialize 
    | SoapMessageStage.beforeDeserialize));

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show: