Back to Devexpress

FileManagerSettingsPermissions.AccessRules Property

aspnet-devexpress-dot-web-dot-filemanagersettingspermissions.md

latest6.2 KB
Original Source

FileManagerSettingsPermissions.AccessRules Property

Gets the collection of access rules specified for the current ASPxFileManager object.

Namespace : DevExpress.Web

Assembly : DevExpress.Web.v25.2.dll

NuGet Package : DevExpress.Web

Declaration

csharp
public AccessRulesCollection AccessRules { get; }
vb
Public ReadOnly Property AccessRules As AccessRulesCollection

Property Value

TypeDescription
AccessRulesCollection

An AccessRulesCollection that contains the collection of access rules.

|

Property Paths

You can access this nested property as listed below:

LibraryObject TypePath to AccessRules
ASP.NET MVC ExtensionsFileManagerSettings

.SettingsPermissions .AccessRules

| | ASP.NET Web Forms Controls | ASPxFileManager |

.SettingsPermissions .AccessRules

| | RichEditDocumentSelectorSettings |

.PermissionSettings .AccessRules

| | SpreadsheetDocumentSelectorSettings |

.PermissionSettings .AccessRules

|

Remarks

The file manager allows you to define access permissions for folders and files using a set of folder/file access rules. The AccessRules collection contains the specified rules.

Concept

Example

Web Forms (in markup):

aspx
<dx:ASPxFileManager ID="ASPxFileManager1" runat="server">    
    <SettingsPermissions>
        <AccessRules>
            <dx:FileManagerFileAccessRule Edit="Deny" Browse="Allow" Path="*.docx" />
            <dx:FileManagerFolderAccessRule Role="Administrator" EditContents="Allow" Browse="Allow" Path="Documents" />
        </AccessRules>
    </SettingsPermissions>
</dx:ASPxFileManager>

Web Forms (in code):

csharp
ASPxFileManager fm = new ASPxFileManager();
...
FileManagerFileAccessRule fileRule = new FileManagerFileAccessRule();
fileRule.Path = "*.docx";
fileRule.Edit = Rights.Allow;
fileRule.Download = Rights.Allow;

FileManagerFolderAccessRule folderRule= new FileManagerFolderAccessRule();
folderRule.Role = "Administrator";
folderRule.EditContents = Rights.Allow;
folderRule.Browse = Rights.Allow;

FileManager.SettingsPermissions.AccessRules.Add(fileRule);
FileManager.SettingsPermissions.AccessRules.Add(folderRule);
...

MVC:

csharp
@Html.DevExpress().FileManager( settings => {
    settings.Name = "fileManager";

    FileManagerFileAccessRule fileRule = new FileManagerFileAccessRule();
    fileRule.Path = "*.docx";
    fileRule.Edit = Rights.Allow;
    fileRule.Download = Rights.Allow;

    FileManagerFolderAccessRule folderRule= new FileManagerFolderAccessRule();
    folderRule.Role = "Administrator";
    folderRule.EditContents = Rights.Allow;
    folderRule.Browse = Rights.Allow;

    FileManager.SettingsPermissions.AccessRules.Add(fileRule);
    FileManager.SettingsPermissions.AccessRules.Add(folderRule);
    ...
}).BindToFolder(Model).GetHtml()

Online Demo

Example

aspx
<dx:ASPxFileManager ID="FileManager" runat="server" ...>

...

     <SettingsPermissions>
          <AccessRules>
               <dx:FileManagerFolderAccessRule Path="" Edit="Deny" />
               <dx:FileManagerFileAccessRule PathPattern="*.xml" Edit="Deny" />
               <dx:FileManagerFolderAccessRule Path="System" Browse="Deny" />

               <dx:FileManagerFolderAccessRule Path="Documents" Role="DocumentManager" EditContents="Allow" />

               <dx:FileManagerFolderAccessRule Path="Music" Role="MediaModerator" EditContents="Allow" />
               <dx:FileManagerFolderAccessRule Path="Video" Role="MediaModerator" EditContents="Allow" />
               <dx:FileManagerFolderAccessRule Path="" Role="MediaModerator" Upload="Deny" />

               <dx:FileManagerFolderAccessRule Role="Administrator" Browse="Allow" />
               <dx:FileManagerFolderAccessRule Role="Administrator" Edit="Allow" />
          </AccessRules>
     </SettingsPermissions>
</dx:ASPxFileManager>

See Also

FileManagerFileAccessRule

FileManagerFolderAccessRule

Access Rules

File Manager

Online Demo: File Manager - Access Control

FileManagerSettingsPermissions Class

FileManagerSettingsPermissions Members

DevExpress.Web Namespace