Item Property, read only of FormFields class

Property, read only | Member of  ScriptUtils.FormFields | Changes | Purchase | Download

Description

Returns a specific member of a FormFields collection either by position or by key.

Syntax

vItem = FormFields.Item (Index as Variant)
 

Where Type Optional Default Description
 Index  Variant     Field name or index. 

Returns

Variant

Returns

Return value depends on number of source document fields with the same name.
- one ScriptUtils.FormField if the index is a numeric expression
- one ScriptUtils.FormField if the index is a name of a source field and source form contains the name of the souce field only one time.
- ScriptUtils.FormFields collection if index is a name of multiselect field (source form contains the name more than once).
- Empty ScriptUtils.FormField if the name does not match any name of field from the source form.

You can use ScriptUtils.FormFields.Count property to get a number of form items with specified name in the source form.

Remarks

Index is based to 1 (for compatibility with Request.Form).
Use ScriptUtils.FormFields.MultiItem property instead of ScriptUtils.FormFields.Item property to enumerate MULTIPLE SELECT fields.

Examples

Upload - Enumerate source fields using index

<%
'Sample file Fields-Item.asp 
'Enumerate and access source form fields using For-Each
' and using Item(Index)
Option Explicit

'Create upload form
Dim Form: Set Form = Server.CreateObject("ScriptUtils.ASPForm")

'was the Form successfully received?
If Form.State = 0 Then

  Dim Field, Index

  Response.Write "<br>Enumerate source fields using For Each"
  For Each Field In Form
    Response.Write "<br> " & Field.Name & ",Length:" & Field.Length & ", Value:" & Field
  Next

  Response.Write "<br>Enumerate source fields using index"
  For Index = 1 To Form.Items.Count
    Set Field = Form.Items(Index)
    Response.Write "<br> " & Field.Name & ",Length:" & Field.Length & ", Value:" & Field
  Next
End If'Form.State = 0 then
%>  
<br>sample For <A Href=http://www.motobit.com>HugeASP upload</A>
<form name="file_upload" method="POST" ENCTYPE="multipart/form-data" >
<input Name=SourceFile1 Type=File><br>
<input Name=SourceFile2 Type=File><br>
<input Name=Description1><br>
<input Type=CheckBox Checked Name=Check1>Check 1<br>
<input Type=CheckBox Checked Name=Check1>Check 1<br>
<input Type=CheckBox Checked Name=Check2>Check 2<br>
<SELECT NAME="Select field" SIZE="1">
  <OPTION VALUE="Option 1">Option 1
  <OPTION VALUE="Option 1">Option 2
  <OPTION VALUE="Option 1" SELECTED>Option 3
</SELECT><br>
<input Name=SubmitButton Value="Submit >>" Type=Submit><br>
</Form>

<form method="POST">
<input Type=Submit>
</Form>

Script output:

Enumerate source fields using For Each
 SourceFile1,Length:0, Value:
 SourceFile2,Length:0, Value:
 Description1,Length:0, Value:
 Check1,Length:2, Value:on
 Check1,Length:2, Value:on
 Check2,Length:2, Value:on
 Select field,Length:8, Value:Option 1
 SubmitButton,Length:9, Value:Submit >>
Enumerate source fields using index
 SourceFile1,Length:0, Value:
 SourceFile2,Length:0, Value:
 Description1,Length:0, Value:
 Check1,Length:2, Value:on
 Check1,Length:2, Value:on
 Check2,Length:2, Value:on
 Select field,Length:8, Value:Option 1
 SubmitButton,Length:9, Value:Submit >>

See also

FormFields.Count, FormField.Index, FormFields.MultiItem

Other links for Item

Methods of FormFields class

Save

Properties of FormFields class

Count, Files, Item, Items, MultiItem, Texts

ScriptUtils.FormFields

Contains collection of document fields of files.

ScriptUtils

Huge ASP upload is easy to use, hi-performance ASP file upload component with progress bar indicator. This component lets you upload multiple files with size up to 4GB to a disk or a database along with another form fields. Huge ASP file upload is a most featured upload component on a market with competitive price and a great performance . The software has also a free version of asp upload with progress, called Pure asp upload , written in plain VBS, without components (so you do not need to install anything on server). This installation package contains also ScriptUtilities library. Script Utilities lets you create hi-performance log files , works with binary data , you can download multiple files with zip/arj compression, work with INI files and much more with the ASP utility.

© 1996 - 2011 Antonin Foller, Motobit Software | About, Contacts | e-mail: info@pstruh.cz


Other Motobit links:   IISTracer, real-time IIS monitor   ASP file upload - upload files to ASP. 
ActiveX/VBSScript registry editor  ActiveX NT User account manager  Export MDB/DBF from ASP Active LogFile  Email export  ActiveX/ASP Scripting Dictionary object