ASP.NET.in.a.Nutshell.Second.Edition [Electronic resources] نسخه متنی

You can inherit from this class to create a custom SOAP extension,
which allows you to access and manipulate SOAP messages before they
are sent or converted into objects. SOAP extensions can be used to
implement additional encryption, compression, or tracing. They can
also be applied to web services or web service clients.

The key to using a derived SoapExtension class is
overriding the ProcessMessage( ) method. This
method is called automatically by the ASP.NET framework at several
different SoapMessageStages and provides you with
the current SoapMessage object. You also connect
your SoapExtension to a proxy class or web service
method by using a custom SoapExtensionAttribute.

You can initialize a SoapExtension with a
constructor method and the Initialize( ) and
GetInitializer( ) methods. The
GetInitializer( ) method is called only once (the
first time a SOAP request is made). It gives you the opportunity to
retrieve information about the web service or proxy method (in the
methodInfo parameter) and custom
SoapExtensionAttribute and return an appropriate
initialization object. This object will be cached and provided to the
Initialize( ) method, which is called every time a
SOAP request is made.

public abstract class 
SoapExtension  {
// Protected Constructors 
protected 
SoapExtension ( );
// Public Instance Methods
public virtual Stream 
ChainStream (System.IO.Stream 
stream );
public abstract object 
GetInitializer (LogicalMethodInfo 
methodInfo , SoapExtensionAttribute 
attribute );
public abstract object 
GetInitializer (Type 
serviceType );
public abstract void 
Initialize (object 
initializer );
public abstract void 
ProcessMessage (SoapMessage 
message );
}