ASP Object: Request

Object|request

Request Object

The request object retrieves the values that the client browser passes to the server during the HTTP request.

Grammar

Request[.collection|property|method] (variable)  

Collection

ClientCertificate stores the value of a field in a client certificate sent to an HTTP request. The value of the cookie that was sent in the cookieshttp request. Formhttp the value of the table element in the body of the request. Querystringhttp the value of the variable in the query string. ServerVariables the value of the predetermined environment variable.

Property

TotalBytes is only allowed to read. Specifies the total number of bytes sent by the client in the body of the request.

Method

BinaryRead retrieves data that is sent from the client to the server as part of a POST request.

Variable arguments are strings that specify the items to retrieve from the collection, or as input to a method or property. For more information about the variable parameters, see the collection instructions.

Comments

If the specified variable is not one of the five sets above, the Request object returns EMPTY.

You can use all variables directly by calling Request (variable), without the name of the collection. Because of this, the WEB server can search the collection in the following order.

1. QueryString
   
   
2. Form
   
   
3. Cookies
   
   
4. ClientCertificate
   
   
5. ServerVariables

If a variable of the same name appears in more than one collection, the Request object returns the first instance encountered.

We recommend that you use the full name when involving members of the ServerVariables collection. For example, do not Request. (Auth_User) with Request.ServerVariables (AUTH_USER).