please dont rip this site

Form

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

Syntax

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

Parameters

parameter

Specifies the name of the form element from which the collection is to retrieve values.

index

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.

Remarks

Post data (make the form action=) to  http://techref.massmind.org/showformdata.asp to see the form variables and data. or use http://techref.massmind.org/cgi-bin/showall.asp to see everything.

The Form collection is indexed by the names of the parameters in the request body. The value of Request.Form(parameter) is an array of all of the values of parameter that occur in the request body. You can determine the number of values of a parameter by calling Request.Form(parameter).Count. If a parameter does not have multiple values associated with it, the count is 1. If the parameter is not bound, 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(parameter).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, Chocolate and 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.

Chocolate
Butterscotch
 

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 %>
 

Which displays:

FavoriteFlavor = Chocolate
FavoriteFlavor = Butterscotch

Example

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.

firstname=James&flavor=Rocky+Road
 

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
 

Applies To

Request Object

See Also

ClientCertificate, Cookies, QueryString, ServerVariables


© Microsoft Corporation. All rights reserved.


file: /Techref/language/asp/OBJ/introbj_9.htm, 6KB, , updated: 2006/4/28 15:56, local time: 2024/10/6 02:41,
TOP NEW HELP FIND: 
98.84.18.52:LOG IN
©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!

 ©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://www.sxlist.com/TECHREF/language/asp/OBJ/introbj_9.htm"> Form</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?

 

Welcome to sxlist.com!


Site supported by
sales, advertizing,
& kind contributors
just like you!

Please don't rip/copy
(here's why

Copies of the site on CD
are available at minimal cost.
 

Welcome to www.sxlist.com!

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  .