Multi-File Selection
- 2 minutes to read
If used in Advanced Upload Mode, ASPxUploadControl supports multi-file selection capability. It allows end-users to choose several files to upload within a single file open dialog. By default, the multi-file selection mode is disabled. To enable it, switch the UploadAdvancedModeSettings.EnableMultiSelect property to true.
Note
Advanced Upload Mode implementation is based on HTML5 technology. If HTML5 support is not available in an end-user browser, Advanced Upload Mode uses technologies provided by Microsoft Silverlight. If HTML5 is not supported and Silverlight is not installed or is disabled, a specific message is rendered instead of the ASPxUploadControl, providing end-users with a Silverlight download link.
Refer to Advanced Upload Mode topic for more details.
When multi-file selection is on, the ASPxUploadControl text box is used to display information about the current file selection. When selecting a single file, the text box contains the selected file name. When multiple files are selected, the text box displays the total number of selected files. In this case, the text box’ tooltip will contain a list of the selected files.
A list of files selected for upload can be easily cleared by using the Clear file selection button. By default, this button automatically appears within the text box when any file is selected. To disable this button functionality, set the ASPxUploadControl.ShowClearFileSelectionButton property to false.
In advanced upload mode, when multi-file selection is enabled, you can get the information about the current file’s upload process, using the currentFileContentLength, currentFileUploadedContentLength, and currentFileProgress properties of the ASPxClientUploadControl.UploadingProgressChanged event’s argument. The total upload progress information can be accessed via the totalContentLength, uploadedContentLength, and progress arguments.
You can specify the text that is shown when an error occurs in multi-file selection mode via the UploadControlValidationSettings.MultiSelectionErrorText property.