Class name |
FlashMultiUpload |
Properties |
Name=" The name of this object, required" |
|
Action="URL of script that will handle the uploaded file, required" |
|
Style="limited CSS-style to customize FlashMultiUpload user interface. Optional" |
|
RedirectTo="URL that will be redirected to upon upload completeion. Optional" |
|
ShowUploadButton="true/false. Show the upload button in FlashMultiUpload object. Optional, default=true" |
|
MaxFile="Maximum number of file allowed for upload |
|
MaxFileSize="Maximum file size allowed for upload in bytes. Optional, default=0=unlimited" |
|
MaxFileSizeTotal="Maximum total file size allowed for upload in bytes. Optional, default=0=unlimited" |
|
FileFilter="List of title and file extensions allowed for upload. Optional, default=all files" |
|
OnProgress="Name of JavaScript function that will handle events send from FlashMultiUpload. Optional" |
Methods |
write |
|
Write FlashMultiUpload object to response buffer |
Limitation: Due to limitation in Flash, HTML, Webserver and ASP, below restrictions apply: 1. FlashUpload CAN NOT be included in the <form>. Instead put this tag outside the form, and do the upload using JavaScript (if ShowUploadButton is set to false) Check this file: example_2.cfm on how to achieve this. 2. The uploaded formfield always use the name: "Filedata". So the "Action" URL must handle this request.form("FileData") variable. 3. MaximumFileSize is also limited by Flash, ASP and webserver configuration. Please consult ASP and your webserver documentation to allow large file upload (Eg: 64MB or more)
We encourage downloading the evaluation version first, install and test it in your environment. Click here to download the free evaluation version
Explanation: 1. Style ASP_FlashUpload allow limited CSS-style to be applied to this class. Those are: color and border-color. Other style will be ignored. For example: dim objFlashUpload set objFlashUpload=new FlashMultiUpload objFlashUpload.style="color:#000000; border-color:#cc0000" 'Don't forget to use the "#"
2. MaximumFileSize and MaximumFileSizeTotal The maximum uploaded file size in bytes. See limitation #3 above
3. FileFilter Is a comma delinmited list of title and file extensions allowed to be uploaded. Each extensions is separated by ; For example: To allow MS Word file -> FileFilter="Microsoft Word Files,*.doc;*.rtf" To allow Images -> FileFilter="Images,*.jpg;*.gif;*.png;*.bmp" To allow MS Word, MS Excel, and PDF upload -> FileFilter="Word,*.doc;*.rtf,Excel,*.xls;*.csv,PDF,*.pdf" (Note the "," and ";")
4. OnProgress ASP_FlashMultiUpload allow JavaScript functions to handle event send by the object. For example: dim objFlashUpload set objFlashUpload=new FlashMultiUpload objFlashUpload.OnProgess="WhatIsIt"
In the HTML, you will have to add a JavaScript function named "WhatIsIt" with one parameter <script language="JavaScript"> function WhatIsIt(iFlashUploadStatus) { if (iFlashUploadStatus==1) alert("Upload completed"); else if (iFlashUploadStatus==-1) alert("Upload canceled"); else if (iFlashUploadStatus==-2) alert("Upload Fail: IO error"); else if (iFlashUploadStatus==-2) alert("Upload Fail: Security error"); else if (iFlashUploadStatus==-4) alert("Upload Fail: HTTP Eeror");
if (iFlashUploadStatus==2) document.body.style.cursor="wait"; // uploading else document.body.style.cursor=""; } </script>
5. Triggering upload process from JavaScript To start uploading triggered by JavaScript, call this function: objFlash.FlashUpload_DoUpload() With objFlash is the FlashMultiUpload object in your HTML.
To get this objFlash, you can use this code snippet: if(navigator.appName.indexOf("Microsoft") != -1) objFlash = window.#form.FlashUploadName#; else objFlash = window.document.#form.FlashUploadName#;
6. FlashMultiUpload functions that can be called from JavaScript are: FlashUpload_DoUpload -> to start file upload, as explained above FlashUpload_GetXMLResult -> to get the XML result of each file status FlashUpload_GetStatus -> to get the last status of FlashUpload 1 = upload completed 0 = upload hasn't been enabled. File not selected -1 = upload canceled -2 = upload fail because of IO error -3 = upload fail because of security error -4 = upload fail because of HTTP error
7. The XML result is in below format: <Files> <File> <Name>Original uploaded filename</Name> <Size>File size in bytes</Size> <Status>Upload status 1,0,-1,-2,-3,-4 as described above</Status> </File> <File> <Name>Original uploaded filename</Name> <Size>File size in bytes</Size> <Status>Upload status 1,0,-1,-2,-3,-4 as described above</Status> </File> ... and so on </Files> You have to parse the XML to retrieve all uploaded files. Please see upload_2_data.asp to see how XML parsing can be done easily with only several lines.
|