RadAsyncUpload Object

The following table lists the important RadAsyncUpload client-side methods:

 

Name	Parameters	Return Type	Description
addFileInput	none	none	Adds a new row to the RadAsyncUpload control. See Example 1.
deleteFileInputAt	integer	none	Deletes the row at the specified (0-based) index if it exists. See Example 2.
deleteAllFileInputs	none	none	Deletes all rows with the uploaded files.
getUploadedFiles	none	array	Returns an array containing the names of the uploaded files. See Example 3.
getID	string	string	Creates a new ID, based on the RadAsyncUpload ClientID, the supplied parameter, and the zero based index of the current row. See Example 4.
isExtensionValid	string	boolean	Validates the extension of the file name that is passed as a parameter. See Example 5.
get_maxFileCount	none	integer	Returns the maximum number of rows in the RadAsyncUpload control.
set_maxFileCount	integer	none	Sets the maximum number of rows in the RadAsyncUpload control.
get_initialFileInputsCount	none	integer	Returns the initial number of rows when the RadAsyncUpload control is first loaded.
get_allowedFileExtensions	none	array	Returns an array containing the allowed file extensions.
get_element	none	HTML element	Returns the DOM element for the RadAsyncUpload control.
get_loadedModuleName	none	string	Returns string representation of the loaded upload module name. It could be one of the following: Silverlight/Flash/IFrame

Example 1: Add a new row to the RadAsyncUpload.

ASPNET

<telerik:RadAsyncUpload RenderMode="Lightweight" runat="server" id="RadAsyncUpload1" />
<input type="button" value="Add" onclick="myAdd()" />
<script type="text/javascript">
    function myAdd() {
        $find("<%= RadAsyncUpload1.ClientID%>").addFileInput();
    }
</script>

Example 2: Delete the file at the specified index.

JavaScript

function DeleteInvalidFiles() {
  var upload = $find("<%= RadAsyncUpload1.ClientID %>");
  var inputs = upload.getUploadedFiles();
  for (i = inputs.length - 1; i >= 0;i--) {
    if(!upload.isExtensionValid(inputs[i].value))
       upload.deleteFileInputAt(i);
  }
}		

Be careful to use the right index because in different scenarios file inputs may be ordered differently in RadAsyncUpload .

Example 3: Get the uploaded files names.

JavaScript

function ClearInvalidInputs() {
  var upload = $find("<%= RadAsyncUpload1.ClientID %>");
  var inputs = upload.getUploadedFiles();
  for (i = inputs.length - 1; i >= 0;i--) {
    alert(inputs[i] + " was  uploaded");    
  }
}			

Example 4: Create a new ID.

ASPNET

<telerik:RadAsyncUpload RenderMode="Lightweight" runat="server" id="RadAsyncUpload1" OnClientAdded="addTitle" />
<script type="text/javascript">
    function addTitle(RadAsyncUpload, args) {
        var row = args.get_row();
        var title = document.createElement("input");
        title.id = title.name = RadAsyncUpload.getID("title");
        row.insertBefore(title, row.firstChild);
    }
</script>

This method must be used when adding custom fields to a RadAsyncUpload instance.

Example 5: Validate the file extension.

JavaScript

function ClearInvalidInputs() {
	var upload = $find("<%= RadAsyncUpload1.ClientID %>");
	var inputs = upload.getUploadedFiles();
	for (i = inputs.length - 1; i >=0; i--) {
	if (!upload.isExtensionValid(inputs[i]))
		alert("extension is invalid!")	  
}		

See Also

Getting Started

Client-Side Basics

Client-Side Events