This documentation is archived and is not being maintained.

SoapMessage.EnsureOutStage Method

When overridden in a derived class, asserts that the current SoapMessageStage stage is a stage where out parameters are available.

[Visual Basic]
Protected MustOverride Sub EnsureOutStage()
[C#]
protected abstract void EnsureOutStage();
[C++]
protected: virtual void EnsureOutStage() = 0;
[JScript]
protected abstract function EnsureOutStage();

Exceptions

Exception Type Condition
InvalidOperationException Out parameters are not available.

Remarks

The asserted stage is different for XML Web service clients and XML Web service methods. An XML Web service method's out parameters are available prior to the SOAP response serialization process in the BeforeSerialize stage. In an XML Web service client, the out parameters are available after the SOAP response deserialization process in the AfterDeserialize stage.

EnsureOutStage can be called during any SoapMessageStage, however an InvalidOperationException is thrown when out parameters are not available.

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: