Sideway from Sideway

Draft for Information Only


Request Object

Request Object

The Request object is an instance of the System.Web.HttpRequest class. Request object of ASP.NET is related to retrieving data by the server from the client.

Tthe Request property of the Page class can be use to access the HttpRequest instance for the current request. For example, Request["key"] can be used for accessing data from the QueryString, Form, Cookies, or ServerVariables collections.

The methods and properties of the HttpRequest class are exposed through the Request properties of the HttpApplication, HttpContext, Page, and UserControl classes.

Note: Unicode support for HttpRequest class members requires IIS version 6.0 or later.


Constructor Description
HttpRequest(String, String, String) Initializes an HttpRequest object.


Property Description
AcceptTypes Gets a string array of client-supported MIME accept types.
AnonymousID Gets the anonymous identifier for the user, if present.
ApplicationPath Gets the ASP.NET application's virtual application root path on the server.
AppRelativeCurrentExecutionFilePath Gets the virtual path of the application root and makes it relative by using the tilde (~) notation for the application root (as in "~/page.aspx").
Browser Gets or sets information about the requesting client's browser capabilities.
ClientCertificate (collection) Gets the current request's client security certificate.
ContentEncoding Gets or sets the character set of the entity-body.
ContentLength Specifies the length, in bytes, of content sent by the client.
ContentType Gets or sets the MIME content type of the incoming request.
Cookies (collection) Gets a collection of cookies sent by the client.
CurrentExecutionFilePath Gets the virtual path of the current request.
FilePath Gets the virtual path of the current request.
Files Gets the collection of files uploaded by the client, in multipart MIME format.
Filter Gets or sets the filter to use when reading the current input stream.
Form (collection) Gets a collection of form variables.
Headers Gets a collection of HTTP headers.
HttpChannelBinding Gets the ChannelBinding object of the current HttpWorkerRequest instance.
HttpMethod Gets the HTTP data transfer method (such as GET, POST, or HEAD) used by the client.
InputStream Gets the contents of the incoming HTTP entity body.
IsAuthenticated Gets a value indicating whether the request has been authenticated.
IsLocal Gets a value indicating whether the request is from the local computer.
IsSecureConnection Gets a value indicating whether the HTTP connection uses secure sockets (that is, HTTPS).
Item[String] Gets the specified object from the QueryString, Form, Cookies, or ServerVariables collections.
LogonUserIdentity Gets the WindowsIdentity type for the current user.
Params Gets a combined collection of QueryString, Form, Cookies, and ServerVariables items.
Path Gets the virtual path of the current request.
PathInfo Gets the additional path information for a resource with a URL extension.

Gets the physical file system path of the currently executing server application's root directory.

PhysicalPath Gets the physical file system path corresponding to the requested URL.
QueryString (collection) Gets the collection of HTTP query string variables.
RawUrl Gets the raw URL of the current request.
RequestType Gets or sets the HTTP data transfer method (GET or POST) used by the client.
ServerVariables(collection) Gets a collection of Web server variables.
TotalBytes Gets the number of bytes in the current input stream.
Url Gets information about the URL of the current request.
UrlReferrer Gets information about the URL of the client's previous request that linked to the current URL.
UserAgent Gets the raw user agent string of the client browser that has been provided. Please note it may be null.
UserHostAddress Gets the IP host address of the remote client.
UserHostName Gets the DNS name of the remote client.
UserLanguages Gets a sorted string array of client language preferences.


Method Description
BinaryRead(Int32) Performs a binary read of a specified number of bytes from the current input stream.
Equals(Object) Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode() Serves as the default hash function. (Inherited from Object)
GetType() Gets the Type of the current instance. (Inherited from Object)
MapImageCoordinates(String) Maps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values.
MapPath(String) Maps the specified virtual path to a physical path.
MapPath(String, String, Boolean) Maps the specified virtual path to a physical path.
MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object)
SaveAs(String, Boolean) Saves an HTTP request to disk.
ToString() Returns a string that represents the current object. (Inherited from Object)
ValidateInput() Causes validation to occur for the collections accessed through the Cookies, Form, and QueryString properties.


  • For an unknown variable of collection of a Request, The Request object returens EMPTY
  • The collection name can be omitted by directly calling the variable as the variable of the function. i.e. Request(variable)
  • If no collection name is specified, the web server searches the variable name in the collections in the order of: QueryString, Form, Cookies, ClientCertificate and ServerVariables and only the value of first instance will be returned
  • The methods and properties of ASP request object can be grouped into
    • ReadOnly property: TotalBytes;
    • Data Stream: BinaryRead;
    • Data Field/Collection: QueryString; Form; Cookies; ClientCertificate; ServerVariables.






  1. Active Server Pages,, updated 20Dec2012
  2. ASP Overview,, updated 21Dec2012
  3. ASP Best Practices,, updated 15Apr2013
  4. ASP Built-in Objects,, updated 20Dec2012
  5. Response Object,, updated 20Dec2012
  6. Request Object,, updated 20Dec2012
  7. Server Object (IIS),, updated 20Dec2012
  8. Application Object (IIS),, updated 20Dec2012
  9. Session Object (IIS),, updated 20Dec2012
  10. ASPError Object,, updated 20Dec2012
  11. ObjectContext Object (IIS),, updated 20Dec2012
  12. Debugging Global.asa Files,, updated 15Apr2013
  13. How to: Debug Global.asa files,, updated 15Apr2013
  14. Calling COM Components from ASP Pages,, updated 15Apr2013
  15. IIS ASP Scripting Reference,, updated 15Apr2013
  16. ASP Keywords,, updated 15Apr2013
  17. Creating Simple ASP Pages,, updated 15Apr2013
  18. Including Files in ASP Applications,, updated 15Apr2013
  19. ASP Overview,, updated 15Apr2013
  20. FileSystemObject Object,, updated 14Mayr2013
  21., ADO Object Model, updated 15Apr2013
  22. ADO Fundamentals,, updated 14Mayr2013

ID: 190500029 Last Updated: 2019/5/29 Revision: Ref:


Home (5)



HBR (3)



Hobbies (7)


Chinese (1097)

English (336)

Reference (66)


Hardware (149)


Application (187)

Digitization (24)

Numeric (19)


Web (644)new



Regular Expression (SC)


Knowledge Base

Common Color (SC)

Html Entity (Unicode) (SC)

Html 401 Special (SC)

OS (389)new

MS Windows

Windows10 (SC)

.NET Framework (SC)

DeskTop (7)



Formulas (8)

Number Theory (206)

Algebra (20)

Trigonometry (18)

Geometry (18)

Calculus (67)

Complex Analysis (21)


Tables (8)


Mechanics (1)

Rigid Bodies

Statics (92)

Dynamics (37)

Fluid (5)

Fluid Kinematics (5)


Process Control (1)

Acoustics (19)

FiniteElement (2)

Biology (1)

Geography (1)

Latest Updated Links

Copyright © 2000-2019 Sideway . All rights reserved Disclaimers last modified on 10 Feb 2019