FileManagerSettingsEditing.AllowRename Property

Gets or sets a value specifying whether items can be renamed.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

C#

[DefaultValue(false)]
public virtual bool AllowRename { get; set; }

VB.NET

<DefaultValue(False)>
Public Overridable Property AllowRename As Boolean

Property Value

Type	Default	Description
Boolean	false	true, if item renaming is allowed; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to AllowRename
ASP.NET MVC Extensions	FileManagerSettings	.SettingsEditing .AllowRename
ASP.NET Web Forms Controls	ASPxFileManager	.SettingsEditing .AllowRename

Remarks

Use the AllowRename property to control whether items can be renamed.

An end-user can rename a file manager item using the toolbar rename button or context menu Rename item, whose availability depends on the AllowRename property value.

Toolbar Rename Button

The rename button is displayed in the toolbox if the FileManagerSettingsToolbar.Items collection contains an object of the FileManagerToolbarRenameButton type. In this case, the AllowRename property specifies the button’s availability.

When the FileManagerSettingsToolbar.Items collection is empty, the AllowRename property specifies the rename button visibility.

Context Menu Rename Item

The rename item is displayed in the context menu if the FileManagerSettingsContextMenu.Items collection contains an object of the FileManagerToolbarRenameButton type, or if the FileManagerSettingsContextMenu.Items collection is empty. The AllowRename property specifies the item availability.

Example

Web Forms (in markup):

ASPX

<dx:ASPxFileManager ID="fileManager" runat="server" >
    <SettingsEditing AllowCreate="true" AllowDelete="true" AllowMove="true" AllowRename="true" 
    AllowCopy="true" AllowDownload="true" />    
    ...
</dx:ASPxFileManager>

Web Forms (in code):

C#

ASPxFileManager fm = new ASPxFileManager();
...
fm.SettingsEditing.AllowCreate = true;
fm.SettingsEditing.AllowDelete = true;
fm.SettingsEditing.AllowMove = true;
fm.SettingsEditing.AllowRename = true;
fm.SettingsEditing.AllowCopy = true;
fm.SettingsEditing.AllowDownload = true;

MVC:

C#

@Html.DevExpress().FileManager( settings => {
    settings.Name = "fileManager";
    settings.SettingsEditing.AllowCreate = true;
    settings.SettingsEditing.AllowDelete = true;
    settings.SettingsEditing.AllowMove = true;
    settings.SettingsEditing.AllowRename = true;
    settings.SettingsEditing.AllowCopy = true;
    settings.SettingsEditing.AllowDownload = true;
    ...
}).BindToFolder(Model).GetHtml()

Online Demo

• ASPxFileManager - Features (Web Forms)

• FileManager - Features (MVC)

Example

The image below demonstrates the example’s file structure in the web site solution explorer and in the file manager.

The code sample below demonstrates an example of the ASPxFileManager control’s markup.

ASPX

<dx:ASPxFileManager ID="ASPxFileManager1" runat="server" Width="700px">
     <Settings RootFolder="~\Files\" ThumbnailFolder="~\Thumbnails\" 
          AllowedFileExtensions=".jpg, .jpeg, .gif, .rtf, .txt, .avi, .png, .mp3, .xml, .doc, .pdf" InitialFolder="Images\Employees" />
     <SettingsEditing AllowCreate="True" AllowDelete="True" AllowMove="True" AllowRename="True" />
     <SettingsPermissions>
          <AccessRules>
               <dx:FileManagerFolderAccessRule Edit="Deny" />
               <dx:FileManagerFolderAccessRule Edit="Allow" Path="Documents\Reports" />
          </AccessRules>
     </SettingsPermissions>
</dx:ASPxFileManager>