New to Telerik UI for ASP.NET AJAX? Download free 30-day trial

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.

<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.

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.

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.

<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.

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

In this article