Form Property

Applies To  

This property returns the values of the form elements sent using the POST method. (Form collection, Read-Only.)

Syntax (VBScript)

Value = Request.Form(FieldName)(Index).Property

Syntax (JavaScript)

Value = Request.Form.Item(FieldName)(Index).Property

It is recommended that you use the helper_js.csp file for cross-platform compatibility. See Some key functions in helper_js.csp for more information.

Parts

Value

The variant value of the requested field.

FieldName

Optional string value for the name of the field on the form you are trying to retrieve. If you do not specify this item, then one of the properties listed in Form Collection Properties must be specified. If you do specify this item, you may still specify the Property item, although in this case it will be one of the items defined in Form Field Properties.

Index

Optional integer value for an index that enables you to select a particular value from an form field that has multiple values. For example a combo box that allows you to select multiple values. The index is one-based.

Property

Optionally specify one of the properties described in Form Collection Properties. Specify this if you have not included the FieldName. If you did include the FieldName, then this will be one of the properties described in Form Field Properties.

Remarks:

If you do not use any parameters when using this property, the server will return the entire HTTP request body without parsing it. Although there is no limit to the amount of data that can be transferred using this method, it is recommend that if the size of the data is greater than 100KB, you use the BinaryRead Method.

Forms belong to collections with Form Collection Properties. Forms also contain form fields with Form Field Properties.

Form Collection Properties

Property Description

Count

The number of fields in the form. (Long)

Item (Index)

Given a name or ordinal value returns a field from the form. (FormField)

Form Field Properties

Property Description

Count

The number of values a particular field on the form has. Use this in conjunction with the Index item to iterate through all the values a particular field has: you must use a For Each loop to do this. (Long)

Item (Index)

Given an ordinal value returns the value of a field on the form. Note that a single field may have multiple values. You may access these using the index property.



Crystal Decisions, Inc.
http://www.crystaldecisions.com
Support services:
http://support.crystaldecisions.com