please dont rip this site

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

Request.Form Collection

The Form collection retrieves the values of form elements posted to the HTTP request body, with a form using the POST method.

As a security precaution, always encode form input (or any request data) before using it. A general method of encoding data is to use Server.HTMLEncode. Another method is to write a short function that tests request data for invalid characters. More information can be found by reading chapter 12 of Writing Secure Code, and using Checklist: ASP Security when you create your ASP applications.


Request.Form( element)[( index)|.Count]


The name of the form element from which the collection is to retrieve values.
An optional parameter that enables you to access one of multiple values for a parameter. It can be any integer in the range 1 to Request.Form( parameter).Count.


The Form collection is indexed by the names of the parameters in the request body. The value of Request.Form( element) is an array of all the values of element that occur in the request body. You can determine the number of values of a parameter by calling Request.Form( element).Count. If a parameter does not have multiple values associated with it, the count is 1. If the parameter is not found, the count is 0.

To reference a single value of a form element that has multiple values, you must specify a value for the index parameter. The index parameter may be any number between 1 and Request.Form( element).Count. If you reference one of multiple form parameters without specifying a value for index, the data is returned as a comma-delimited string.

When you use parameters with Request.Form, the Web server parses the HTTP request body and returns the specified data. If your application requires unparsed data from the form, you can access it by calling Request.Form without any parameters.

 Note  When using ASP and posting large amounts of data more than 100 KB, Request.Form cannot be used. If your application requires posting data greater than this limit, a component can be written that uses the Request.BinaryRead method.

You can iterate through all the data values in a form request. For example, if a user filled out a form by specifying two values, Chocolate and Butterscotch, for the FavoriteFlavor element, you could retrieve those values by using the following script.

  For i =index.html 1 To Request.Form("FavoriteFlavor").Count
    Response.Write Request.Form("FavoriteFlavor")(i) & "<BR>"

The preceding script would display the following.

Chocolate Butterscotch

You can use this technique to display the parameter name, as shown in the following script:


  For i =index.html 1 to Request.Form("FavoriteFlavor").count %>

    Request.Form(FavoriteFlavor) = <%= Request.Form("FavoriteFlavor")(i)_

    %> <BR>

<% Next %>

This script displays the following in the browser.

Request.Form(FavoriteFlavor) =index.html Chocolate

Request.Form(FavoriteFlavor) = Butterscotch


Consider the following form:

<FORM ACTION =index.html "/scripts/submit.asp" METHOD = "post">
<P>Your first name: <INPUT NAME = "firstname" SIZE = 48>
<P>What is your favorite ice cream flavor: <SELECT NAME = "flavor">

From that form, the following request body could be sent:


The following script can then be used:

Welcome, <%=index.html Request.Form("firstname") %>.
Your favorite flavor is <%= Request.Form("flavor") %>.

The following output is the result:

Welcome, James. Your favorite flavor is Rocky Road.

 Caution  In the example above, the user's input is echoed without validation, which could pose a security risk. For more information, see MS Press - Writing Secure Code

If the following script is used:

The unparsed form data is:  <%=index.html Request.Form %>

The output would be:

The unparsed form data is:  firstname=James&flavor=Rocky+Road

Note  If your form includes multiple objects with the same name (for example, HTML SELECT tags), the item in the form collection will be a comma-delimited list of all the selected values.

Applies To

Request Object

See Also


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_reqocf.htm, 6KB, , updated: 2020/6/28 18:54, local time: 2024/6/21 12:26,

 ©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=""> Request.Form Collection</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.

Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.

Welcome to!