Programmer's Samples

With the SA-FileUp distribution, we provide a hierarchy of directories that contains many sample ASP scripts that demonstrate the extensive capabilities of SA-FileUp. This page briefly describes the samples contained in the Samples directory.

To install the samples, copy the Samples directory tree included in this distribution to a location on your web server. Using Internet Service Manager (IIS3) or the Microsoft Management Console (IIS4), add a virtual directory that has both read and execute permission. Also make sure that the default document is "default.htm".

Please see the DEFAULT.HTM in the Samples directory.

* Indicates that you must have separate product from Software Artisans installed to run the sample code.

Samples by Topic
Topic	Sample	Directory Location of Samples
File Upload	Uploading File(s) Using a Form	\UploadSamples
	* Client-Side Component Upload	\ClientUpload
	Uploading to a Database	\UploadToDatabase
	* Recursive Directory Upload	\Recursive
File Download	Downloading From a Server	\DownloadSamples\DatabaseDownload
File Download	* Client-Side Component Download	\ClientDownload
Transactional Upload	Transactional Upload	\TransactionalUpload
Visual Basic WebClass	Visual Basic WebClass Sample	\VBWebClass
Browser Neutral	* Browser Neutral	\BrowserNeutral
SA-FileManager	General Samples	\FilemanagerSamples
	Security Samples	\Security
	Encryption Samples	\FileManagerSamples\Encryption
	INI file Manipulation Sample	\FilemanagerSamples\IniFiles
	File Content Samples	\FilemanagerSamples\FileContent
	Importing/Exporting Database Blobs	\FilemanagerSamples\DataBaseBlob
	Visual Basic Samples	\FilemanagerSamples\VB
Sample Application	Advanced Document Manager Sample	\Applications
Miscellaneous Sample	Miscellaneous Samples	\Misc
SA-Archive	Samples	\SAArchive
SA-SMTP	Samples	\SASMTP

Uploading File(s) Using a Form
	Simple	Demonstrates a simple file upload with error checking.
	Intermediate	Demonstrates file upload with other form elements.
	TwoFiles	Uploads two (or more) files in a single form.
	Rename	Uploads a file. If the file with that name already exists on the server, place the uploaded file in a temporary, unique location and ask the user to rename or cancel the upload.
	Multi-select	Handles selection boxes with multiple select values in a sub-collection.
	DeleteUpload	Deletes the uploaded File after it has been saved.
	Control File Type	Controls the file type allowed to be uploaded.
	One Page Upload	Uploads file within one page.
	Alternate multiple file	Demonstrates how to use a conditional statement to control the number of uploads.

* Client-Side Component Upload
*	SA-JFile Preset File Upload	Uploads two files and saves them to a virtual directory with Progress Indication using SA-JFile.
*	SA-XFile Preset File Upload	Uploads two files and saves them to a virtual directory with Progress Indication using SA-XFile.
*	SA-JFile Hidden Upload	Uploads a hidden scripted file using SA-JFile.
*	SA-XFile Hidden Upload	Uploads a hidden scripted file using SA-XFile.
*	SA-JFile Multiple Upload	Uploads multiple files using SA-JFile.
*	SA-XFile Multiple Upload	Uploads multiple files using SA-XFile.
*	SA-JFile Restrict File Size/Type	Restricts the file size and type within an upload using SA-JFile.
*	SA-XFile Restrict File Size/Type	Restricts the file size and type within an upload using SA-XFile.

Uploading to a Database
Please see the Database Setup Instructions before using these database samples.
	Simple	Shows a simple file upload to a database with error checking.
	Intermediate	Uploads a file to a database with other form elements.
	Filename Upload	Uploads a file into database, adding a filename into a field.

Downloading from the Server
	Simple	Downloads a MS Word document that will launch Word, using both Navigator and Internet Explorer.
	SaveAsDialog	Downloads the same MS Word document. Rather than launching Word, the user is prompted with a "Save As" dialog box.
	SimpleDatabase	Same as the Simple Download example, but the source of the file is contained in a binary column in the UPLOAD.MDB database.
	Framed Sample	Starts a download and sends a "Thank You" message at the same time. Since the web functions by single request / single response, the only way to send back a message concurrently with a download is to use HTML Frames.

* Client-Side Component Download
*	SA-JFile Simple Download	Shows a simple download using the client-side component SA-JFile.
*	SA-XFile Simple Download	Shows a simple download using the client-side component SA-XFile.
*	SA-JFile Multiple Download	Shows a multiple-file download using the client-side component SA-JFile.
*	SA-XFile Multiple Download	Shows a multiple-file download using the client-side component SA-XFile.

Transactional Upload
	Simple	Uploads one file using Transaction Server.
*	Intermediate	Shows the client-side component SA-XFile uploading files using Transaction Server.
	Transactional Database Upload	Uploads a file into a database with form elements. Rolls back the transaction if there are form or database errors.

Visual Basic WebClass Sample
	Readme	Demonstrates how to use SA-FileUp from within Visual Basic 6.0 Web Classes.

* Recursive Directory Upload
*	RecursiveJfile	Shows the client-side component SA-JFile uploading whole directories including subdirectories.
*	RecursiveXfile	Shows the client-side component SA-XFile uploading whole directories including subdirectories.

* Browser Neutral
*	UploadBrowser	Shows Active-X Control or Java Applet uploading based on browser capablities using SA-JFile and SA-XFile.
*	DownloadBrowser	Shows Active-X Control or Java Applet downloading based on browser capablities using SA-JFile and SA-XFile.

File Manager General Samples
	DirWalk	Demonstrates how to walk a single directory and show file information.
	Recursive DirWalk	Demonstrates how to walk a complete directory tree.
	DeleteAny	Demonstrates how to use SA-FileManager to delete files from the web server. Use with caution!
	Drives	Demonstrates how to display information about all drives.

File Manager Security Samples
	Simple	Demonstrates how to pick a file and show the owner.
	Add ACE	Demonstrates how to add an Access Control Entry (ACE) to the Access Control List (ACL) of a file.
	Revoke ACE	Demonstrates how to revoke (remove) an Access Control Entry (ACE) of a file.
	Logon User	Demonstrates how to access protected resources using Logon User.

File Manager Encryption Samples
	Encrypt	Demonstrates how to encrypt a file.
	Decrypt	Demonstrates how to decrypt a file

File Manager .INI File Manipulation Sample
	Ini	Demonstrates Ini functions.

File Manager File Content Samples
	TextStream	Shows creating, reading, and writing a text file.
	Unicode TextStream	Shows creating, reading, and writing an Unicode text file.
	TextStream Properties	Displays TextStream Properties when reading in a text file.
	Unicode TextStream Properties	Displays TextStream Properties when reading in an Unicode text file.
	BinaryStream	Demonstrates how to read in a Gif from the file system.

File Manager Importing/Exporting Database Blobs
Please see the Database Setup Instructions before using these database samples.
	Import	Imports a Database Blob into a file.
	Export	Exports a file into a Database as a Blob.

File Manager Visual Basic Samples
	Readme	Demonstrates various FileManager methods and properties in Visual Basic.

Advanced Document Manager Sample
	Advanced Document Manager	This is an advanced document management system. It shows how to upload files, download files, store a user name and password associated with a file in a database, and then download using that password. This sample uses a separate database, so please see the Database Setup Instructions before using it.

Miscellaneous Samples
	SaveBinaryAs	This method takes the HTTP Post stream and saves it to the specified file. This could be used in conjunction with an external MIME decoder, to diagnose specific browser problems, or to learn more about the internals of HTML forms.
	JScript Server-Side Upload One file	Demonstrates how to use Jscript server-side script to upload one file.
	JScript Server-Side Upload Two Files	Demonstrates how to use Jscript server-side script to upload two files.
	CDO for NTS	Demonstrates how to upload files into email using CDONTS.

SA-Archive Samples
	Samples	Index of SA-Archive samples.

SA-SmtpMail Samples
	Sample	Demonstrates how to add an attachment using SA-SmtpMail.

Do you have ideas for other sample files that you would like to see?

Please let us know! Send your requests to info@softartisans.com

Programmer's Samples

Uploading File(s) Using a Form

* Client-Side Component Upload

* Client-Side Component Download

* Recursive Directory Upload

* Browser Neutral