Edit

Share via


SoapMessage.EnsureStage(SoapMessageStage) Method

Definition

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

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.

Applies to