The Form collection retrieves the values of form elements posted to the HTTP request body by a form using the POST method.
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 of 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 index. 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.
You can use an iterator to loop through all the data values in a form request. For example, if a user filled out a form by specifying two values,
Butterscotch, for the
FavoriteFlavor parameter, you could retrieve those values by using the following script.
<% For Each item In Request.Form("FavoriteFlavor") Response.Write item & "<BR>" Next %>
The preceding script would display the following.
The same output can be generated with a For...Next loop, as shown in the following script.
<% For i = 1 To Request.Form("FavoriteFlavor").Count Response.Write Request.Form("FavoriteFlavor")(i) & "<BR>" Next %>
You can use this iterator to display the parameter name, as shown in the following script.
<% For Each x In Request.Form %> Request.Form( <%= x %> ) = <%= Request.Form(x) %> <BR> <% Next %>
This script displays the following on the browser.
FavoriteFlavor = Chocolate FavoriteFlavor = Butterscotch
Consider the following form.
<FORM ACTION = "/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"> <OPTION>Vanilla <OPTION>Strawberry <OPTION>Chocolate <OPTION>Rocky Road</SELECT> <p><INPUT TYPE = SUBMIT> </FORM>
From that form, the following request body might be sent.
The following script can then be used.
Welcome, <%= Request.Form("firstname") %>. Your favorite flavor is <%= Request.Form("flavor") %>.
The following output is the result.
Welcome, James. Your favorite flavor is Rocky Road.
If the following script is used
The unparsed form data is: <%= Request.Form %>
the output would be
The unparsed form data is: firstname=James&flavor=Rocky+Road
ClientCertificate, Cookies, QueryString, ServerVariables