[IIS 5.0] [IIS 5.1] [IIS 6.0]

Request Object

The Request object retrieves the values that the client browser passed to the server during an HTTP request.

Syntax

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

Collections

Request.ClientCertificate Collection	The values of fields stored in the client certificate that is sent in the HTTP request.
Request.Cookies Collection	The values of cookies sent in the HTTP request.
Request.Form Collection	The values of form elements in the HTTP request body.
Request.QueryString Collection	The values of variables in the HTTP query string.
Request.ServerVariables Collection	The values of predetermined environment variables.

Properties

Request.TotalBytes

Read-only; specifies the total number of bytes the client is sending in the body of the request.

Methods

Request.BinaryRead

Retrieves data sent to the server from the client as part of a POST request.

Variable parameters are strings that specify the item to be retrieved from a collection or to be used as input for a method or property. For more information about the variable parameter, see the individual collection reference pages.

Remarks

If the specified variable is not in one of the preceding five collections, the Request object returns EMPTY.

All variables can be accessed directly by calling Request( variable) without the collection name. In this case, the Web server searches the collections in the following order:

QueryString
Form
Cookies
ClientCertificate
ServerVariables

If a variable with the same name exists in more than one collection, the Request object returns the first instance that the object encounters.

It is strongly recommended that when referring to members of a collection the full name be used. For example, rather than Request.("AUTH_USER") use Request.ServerVariables("AUTH_USER"). This allows the server to locate the item more quickly.

Requirements

Platforms: Windows 2000 with IIS 5.0 installed, Windows XP with IIS 5.1 installed, Windows Server 2003 family with IIS 6.0 installed

Platform SDK Release: February 2003

file: /Techref/language/asp/obj/ref_vbom_reqo.htm, 3KB, , updated: 2003/5/15 13:19, local time: 2024/12/25 23:42,

^{3.22.75.247:LOG IN}

©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?

Please DO link to this page! Digg it! / MAKE!

<A HREF="http://techref.massmind.org/Techref/language/asp/obj/ref_vbom_reqo.htm"> Request Object</A>

Did you find what you needed?