FormInput Object

Each File.Transfer FormInput object in the FormInputs collection corresponds to an INPUT element in an HTML FORM.  FormInput objects can only be manipulated through the FormInput collection of the Post object.

Properties  ContentType, File, Name, Value (default property)

Properties

ContentType

String value of the content type of the attached file if the TYPE attribute of the INPUT element is set to FILE.

Access: Read
Default: None

Notes: Only FormInput objects for INPUT elements of type FILE will have this property set. The ContentType represents the client's MIME type mapping for the file being uploaded.

Many clients do not supply accurate MIME type information. You may find it more reliable to refer to the File.MimeType property that is derived from the client-supplied file name.

Example: The following example shows how to display the ContentType of a specific FormInput object:

' Code showing initialization of the Post object omitted
Response.Write Post.FormInputs("UPLOAD1").ContentType & "<BR>"

See Also: File.MimeType property

File

A File object that contains the attached file if the TYPE attribute of the INPUT element is set to FILE.

Access: Read/Write
Default: None

Notes: Only FormInput objects for INPUT elements of type FILE will have this property set to a File object. This object will be referencing a temporary file that contains the contents of a file that was uploaded. Refer to the File object for details on how to manipulate an uploaded file.

Example: The following example shows how to display the size of an uploaded file:

' Code showing initialization of the Post object omitted
Response.Write Post.FormInputs("UPLOAD1").File.Size & "<BR>"

See Also: File object

Name

String value representing the NAME attribute of the INPUT element.

Access: Read
Default: None

Notes: This property matches the NAME attribute specified for the corresponding INPUT element on your HTML form. This value can also be used to index the Post.FormInputs collection.

If any INPUT elements on your HTML form do not contain a NAME attribute, they will not appear in the FormInputs collection.

Example: The following example shows how to display the name of the INPUT element:

' Code showing initialization of the Post object omitted
Response.Write Post.FormInputs("INPUT1").Name & "<BR>"

See Also: Post.FormInputs collection

Value

String value of the INPUT element.

Access: Read
Default: None

Notes: Value is the default property representing the data from the input box.  For FILE objects, this property represents the original path of the file on the client's system. Input elements that have multiple values, such as CHECKBOX and SELECT input types, are delimited with ", " (comma and a space). TEXTAREA inputs have each line delimited with vbCRLF (carriage return and linefeed). The Value property can also be referenced as a collection in these cases to access each value or each line seperately.

Example 1: The following example shows how to display the value of the INPUT element:

' Code showing initialization of the Post object omitted
Response.Write Post.FormInputs("INPUT1").Value & "<BR>"

Example 2: The following example shows how to display multiple values for the same named INPUT element:

' Code showing initialization of the Post object omitted
For Each Value In Post.FormInputs("CHECKBOX1").Value
	Response.Write Value & "<BR>"
Next

See Also: Post.FormInputs collection