FileUp Form Property

Form Property

Object: SoftArtisans.FileUp

Syntax: Form (["Form_element_name"])

Type String

Read/Write: Read/Write

Description: This property retrieves the value of the specified form element. It returns form values in the same format as the ASP Request.Form object with the exception of multi-select list boxes (<SELECT MULTIPLE>) or check boxes.

In general, it is preferable to use the FormEx property instead. However, this is not necessary unless you are using multi-select lists or check boxes.

If the form element is a file, it returns the location of the file on the server.

Form_element_name is an optional parameter.

There is one difference between the FileUp form object and the ASP Request.Form: It is possible to retrieve the raw unparsed form by specifying Request.Form without any parameters. This is acceptable when the form is small, such as less than 100 KB. However, in the case of file uploads, the potential size of the data is very large. By design, SA-FileUp does not place the entire contents of files into memory. Thus, FileUp.Form will not return the unparsed data.

SA-FileUp Version 3.0- allows uploads into memory. See the UseMemory Property.

If you require access to the unparsed data, you can use the SaveBinaryAs method and then read back appropriate sections using SA-FileManager.

Example:

	<%
	'---
	'--- To iterate through the collection of all form elements.
	'---
	Response.Write("<TABLE>")
	For Each x in upl.Form
		Response.Write("<TR><TD ALIGN=""RIGHT"">" & x & "</TD><TD>'" & upl.Form(x) & "'</TD></TR>")
	Next
	Response.Write("</TABLE>")
	... %>

Object:	SoftArtisans.FileUp
Syntax:	Form (["Form_element_name"])
Type	String
Read/Write:	Read/Write
Description:	This property retrieves the value of the specified form element. It returns form values in the same format as the ASP Request.Form object with the exception of multi-select list boxes (<SELECT MULTIPLE>) or check boxes. In general, it is preferable to use the FormEx property instead. However, this is not necessary unless you are using multi-select lists or check boxes. If the form element is a file, it returns the location of the file on the server. Form_element_name is an optional parameter. There is one difference between the FileUp form object and the ASP Request.Form: It is possible to retrieve the raw unparsed form by specifying Request.Form without any parameters. This is acceptable when the form is small, such as less than 100 KB. However, in the case of file uploads, the potential size of the data is very large. By design, SA-FileUp does not place the entire contents of files into memory. Thus, FileUp.Form will not return the unparsed data. SA-FileUp Version 3.0- allows uploads into memory. See the UseMemory Property. If you require access to the unparsed data, you can use the SaveBinaryAs method and then read back appropriate sections using SA-FileManager.