Tab

ASPxFileManager.FileUploading Event

Fires on the server side before a file is uploaded, and allows you to cancel the action.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

public event FileManagerFileUploadEventHandler FileUploading
Public Event FileUploading As FileManagerFileUploadEventHandler

Event Data

The FileUploading event's data class is FileManagerFileUploadEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets a value indicating whether the action that raised the event should be canceled. Inherited from FileManagerActionEventArgsBase.
ErrorText Gets or sets a text for the explanatory message. Inherited from FileManagerActionEventArgsBase.
File Gets a file, related to the event.
FileName Gets or sets the name of a file selected to upload.
InputStream Gets a stream object that points to the uploaded file.
OutputStream Gets a stream object that points to the uploaded file.

Remarks

Before each time a file is uploaded on the server side, the FileUploading event occurs, allowing you to cancel the file upload. The event parameter's FileManagerFileUploadEventArgs.File property identifies the file that is being processed. To cancel the upload operation, set the FileManagerActionEventArgsBase.Cancel property to true. In order to show the message, explaining the reason for the upload cancellation, specify the FileManagerActionEventArgsBase.ErrorText property.

Examples

The code below allows end-users to upload only mp3 files to the "Music mp3" folder.

protected void ASPxFileManager1_FileUploading(object source, DevExpress.Web.FileManagerFileUploadEventArgs e) {
      if (e.File.Folder.FullName == "Files\\Music mp3")
            if (e.File.Extension != ".mp3") {
                e.Cancel = true;
                e.ErrorText = "You can only upload mp3 files to this folder";
            }
}
See Also