System.Web.Services.Protocols.SoapExtension Class

The base class for SOAP extensions for XML Web services created using ASP.NET.

See Also: SoapExtension Members


public abstract class SoapExtension


ASP.NET allows a SOAP-related infrastructure to be built by means of an extensibility mechanism. The ASP.NET SOAP extension architecture revolves around an extension that can inspect or modify a message at specific stages in message processing on either the client or the server.

ASP.NET SOAP extensions derive from the System.Web.Services.Protocols.SoapExtension class. The SoapExtension.GetInitializer(LogicalMethodInfo, SoapExtensionAttribute) and SoapExtension.Initialize(object) methods provide alternative mechanisms for initializing the SOAP extension to enhance performance. SoapExtension.ProcessMessage(SoapMessage) is the heart of most SOAP extensions, as the method is called at each stage defined in System.Web.Services.Protocols.SoapMessageStage, allowing the SOAP extension to perform the desired behavior of that specific SOAP extension. For SOAP extensions that need to modify the SOAP request or SOAP response, SoapExtension.ChainStream(System.IO.Stream) provides an opportunity to receive the proposed data to be sent across the wire.


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