SoapMessage.EnsureStage(SoapMessageStage) Method

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

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.

protected:
 void EnsureStage(System::Web::Services::Protocols::SoapMessageStage stage);

protected void EnsureStage (System.Web.Services.Protocols.SoapMessageStage stage);

member this.EnsureStage : System.Web.Services.Protocols.SoapMessageStage -> unit

Protected Sub EnsureStage (stage As SoapMessageStage)

Parameters

stage

SoapMessageStage

The SoapMessageStage asserted.

Exceptions

InvalidOperationException

The current SoapMessageStage is not the asserted stage or stages.

Examples

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(SoapMessageStage.BeforeSerialize | SoapMessageStage.BeforeDeserialize);

   EnsureStage((SoapMessageStage.BeforeSerialize Or SoapMessageStage.BeforeDeserialize))
End Sub

Remarks

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.