The .NET Framework provides comprehensive support for the HTTP protocol, which makes up the majority of all Internet traffic, with the HttpWebRequest and HttpWebResponse classes. These classes, derived from WebRequest and WebResponse, are returned by default whenever the static method WebRequest.Create encounters a URI beginning with "http" or "https". In most cases, the WebRequest and WebResponse classes provide all that is necessary to make the request, but if you need access to the HTTP-specific features exposed as properties, you can typecast these classes to HttpWebRequest or HttpWebResponse.

HttpWebRequest and HttpWebResponse encapsulate a standard HTTP request-and-response transaction and provide access to common HTTP headers. These classes also support most HTTP 1.1 features, including pipelining, sending and receiving data in chunks, authentication, preauthentication, encryption, proxy support, server certificate validation, and connection management. Custom headers and headers not provided through properties can be stored in and accessed through the Headers property.

HttpWebRequest is the default class used by WebRequest and does not need to be registered before you can pass a URI to the WebRequest.Create method.

You can make your application follow HTTP redirects automatically by setting the AllowAutoRedirect property to true (the default). The application will redirect requests, and the ResponseUri property of HttpWebResponse will contain the actual Web resource that responded to the request. If you set AllowAutoRedirect to false, your application must be able to handle redirects as HTTP protocol errors.

Applications receive HTTP protocol errors by catching a WebException with the Status set to WebExceptionStatus. The Response property contains the WebResponse sent by the server and indicates the actual HTTP error encountered.

See also