IsEmpty Property

 Object: SoftArtisans.SAFile
 Syntax: IsEmpty
 Type: Boolean
 Read/Write: Read Only
 Description: This property indicates whether the user specified a valid file to upload.

When a user fills out a form containing a file (<INPUT TYPE="FILE">), there are three possibilities:

  1. The user specifies a valid filename on the local PC.
  2. The user leaves the filename field blank, decides not to transmit a file, but presses the submit button anyway.
  3. The user specifies a filename that is either invalid or indicates a file that is unreadable.

In the second and third cases, the browser does not report an error. The browser simply proceeds with the upload but leaves the file contents of the upload empty.

Your recourse is to let the user perform the upload and test the IsEmpty property.

If the property is True, the user did not transmit a valid file.

If the property is False, the user did transmit a valid file.

If there is more than one file being uploaded in a single page, only the first one is displayed.

To examine the IsEmpty property of multiple files in a single upload, there is an equivalent property for each file object, i.e., upl.FormEx("FILE1").IsEmpty.

See also the IsEmpty property for the SAFileUp object.

 

Previous Page Next Page