Accessing Multiple Form Elements

The previous example is fine if all you want is file uploads. However most people want to capture additional information on the form along with the file, such as a description.

Normally, you can use ASP's Request.Form object to access these other elements on the form. However when uploading files, you must change the Encoding Type to "multipart/form-data". The ASP Request.Form object does not understand data transmitted using this encoding type.

SA-FileUp provides a Form object that provides identical functionality to the ASP Request.Form object, but can understand the encoding type that is specific to file uploads.

Here is an example:

	<HTML>	<HEAD>
	<TITLE>Please Upload Your File</TITLE>
	</HEAD>
	<BODY>
	<form enctype="multipart/form-data" method="post" action="mformresp.asp">
	Enter description: <input type="text" name="descrip"><br>
	Enter filename to upload: <input type="file" name="f1"><br>
	<input type="submit">
	</form>
	</BODY>
	</HTML>

Here would be the file 'mformresp.asp':

	<%@ LANGUAGE="VBSCRIPT" %>
	<HTML><HEAD>
	<TITLE>Upload File Results</TITLE>
	</HEAD>
	<BODY>
	Thank you for uploading your file.<br>
	<% Set upl = Server.CreateObject("SoftArtisans.FileUp") %>
	<% upl.SaveAs "C:\temp\upload.out" %><BR>
	Your description is: '<%=upl.Form("descrip")%>'<BR>
	Total Bytes Written: <%=upl.TotalBytes%>
	</BODY>
	</HTML>

In this case, the definition of the form still uses ENCTYPE="multipart/form-data", but now there is an additional form element containing a text box.

	Enter description: <input type="text" name="descrip"><br>

Let's look at the form's processing (mformresp.asp).

There is still the same creation of an instance. However, in this case we are referring to the form elements (description) explicitly by name.

	<% upl.SaveAs "C:\temp\upload.out" %><BR>
	Your description is: '<%=upl.Form("descrip")%>'<BR>

Like the Request.Form syntax, we use upl.Form("name-of-the-form-element") to refer to the value of the form element.

Since there is only a single file element, we do not have to explicitly specify which one we want to save.

You can use this same mechanism to access all of your form elements, whether they be text boxes, radio buttons, checkboxes, selection boxes, etc.

What did we learn?

Even if there are multiple form elements, you must still use:
- <FORM ENCTYPE="multipart/form-data" ... >
ASP's Request.Form object does not understand this encoding type. Instead use, SA-FileUp's Form object which offers identical functionality.
To refer to elements on the form, use the name of the element on the form, i.e. upl.Form("descrip")

What if you wanted to Add a Second File?