System.Web.Services.Protocols.HttpSimpleClientProtocol Class

Represents the base class for communicating with an XML Web service using the simple HTTP-GET and HTTP-POST protocols bindings.

See Also: HttpSimpleClientProtocol Members


public abstract class HttpSimpleClientProtocol : HttpWebClientProtocol


This class specifies most of the implementation for communicating with an XML Web service over HTTP using encoders to encode the parameters and return values into common MIME formats. These encoders derive from the System.Web.Services.Protocols.MimeFormatter class. By default, a proxy class deriving from System.Web.Services.Protocols.HttpSimpleClientProtocol encodes parameters using the application/x-www-form-urlencoded MIME type and the response in plain XML. Custom mime formatters can be specified using the System.Web.Services.Protocols.HttpMethodAttribute attribute, however, there is no support for integrating this into a service description and proxy generation.

Notes to Inheritors: When you override this class, you can introduce methods in the derived class that are specific to a particular type of an XML Web service. The methods simply capture the parameters, and call the base class to do the work of communicating with the site. If the introduced methods are asynchronous, call the HttpSimpleClientProtocol.BeginInvoke(string, string, Object[], AsyncCallback, object) and HttpSimpleClientProtocol.EndInvoke(IAsyncResult) methods. If the introduced methods are synchronous, call the HttpSimpleClientProtocol.Invoke(string, string, Object[]) method. The overridden constructor typically sets the WebClientProtocol.Url property to the URI of the XML Web service method.

The Web Services Description Language tool (Wsdl.exe) generates derived classes of System.Web.Services.Protocols.HttpSimpleClientProtocol for a given Service Description.


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