ColdFusion.FileUpload.cancelUpload

Description

At any point during the upload of files, you can choose to cancel the upload. When you cancel the upload, any further upload of files stops.

Function syntax

ColdFusion.FileUpload.cancelUpload(name)

History

ColdFusion 9: Added this function

Parameters

Parameter

Description

name

The value of the name attribute in the cffileupload tag.

Returns

This function does not return a value.

Example

This example includes a button for the Cancel Upload action. When you click this button, the file upload is canceled.

<h3>This is an example of the FileUpload.cancelUpload function. Add a few files to upload and click Upload. During upload, click the Cancel Upload HTML button to cancel the upload.</h3> 
    <script language="JavaScript" type="text/javascript"> 
    function onCancel() { 
    ColdFusion.FileUpload.cancelUpload('myupload'); 
    }; 
    </script> 
    <cffileupload 
    url="uploadAll.cfm" 
    progressbar="true" 
    name="myupload" 
    addButtonLabel = "Add File" 
    clearButtonlabel = "Clear it" 
    width=600 
    height=400 
    title = "File Upload" 
    maxuploadsize="30" 
    extensionfilter="*.jpg, *.png, *.flv, *.txt" 
    BGCOLOR="##FFFFFF" 
    MAXFILESELECT=10 
    UPLOADBUTTONLABEL="Upload now"/> 
    <cfform name="form01"> 
    <cfinput type="button" name="cancelupld" value="Cancel Upload" 
    onclick="onCancel()"> 
    </cfform>