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.v23.2.dll
NuGet Package: DevExpress.Web
Declaration
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.
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";
}