Tab

ASPxFileManager.FolderCreating Event

Fires on the server side before a folder is created and allows you to cancel the action.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v21.2.dll

Declaration

public event FileManagerFolderCreateEventHandler FolderCreating

Event Data

The FolderCreating event's data class is FileManagerFolderCreateEventArgs. 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.
Name Gets the name of the newly created folder.
ParentFolder Gets the parent folder for the newly created item.

Remarks

Before each time a folder is created on the server side, the FolderCreating event occurs, allowing you to cancel folder creation. You can use the event parameter’s properties to identify a name (FileManagerFolderCreateEventArgs.Name) and a parent folder (FileManagerFolderCreateEventArgs.ParentFolder) of the newly created folder. To cancel the create operation, set the FileManagerActionEventArgsBase.Cancel property to true. In order to show the message explaining the reason for the cancellation, specify the FileManagerActionEventArgsBase.ErrorText property.

Example

The code below demonstrates how you can handle the FolderCreating event, to prevent creation of child folders for the root folder.

The image below shows the result.

ASPxFileManager - FolderCreating

protected void ASPxFileManager1_FolderCreating(object source, DevExpress.Web.FileManagerFolderCreateEventArgs e) {
      if (e.ParentFolder.FullName == "Files")
            e.Cancel = true;
            e.ErrorText = "You cannot create child folders for the root folder";
}
See Also