Class: SoftArtisans.FileUp

Property: Form

Input: String

Output: Member of UploadDictionary

Read/Write

Description: This retrieves the value of the specified form element. It returns form values in the same format as the ASP Request.Form object.

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

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. In summary, FileUp.Form will not return the unparsed data.

If you require access to the unparsed data, it is possible to use the SaveBinaryAs method and then read back appropriate sections using the Scripting.FileSystemObject.

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>")
... %>