FileManagerSettingsPermissions.Role Property

Gets or sets a security role that is enforced on the ASPxFileManager.

Assembly : DevExpress.Web.v25.2.dll

Declaration

C#
VB.NET

csharp

[DefaultValue("")]
public string Role { get; set; }

<DefaultValue("")>
Public Property Role As String

Property Value

Type	Default	Description
String	String.Empty

A String value specifying a security role name.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to Role
ASP.NET MVC Extensions	FileManagerSettings

.SettingsPermissions .Role

| | ASP.NET Web Forms Controls | ASPxFileManager |

.SettingsPermissions .Role

| | RichEditDocumentSelectorSettings |

.PermissionSettings .Role

| | SpreadsheetDocumentSelectorSettings |

.PermissionSettings .Role

Remarks

The file manager allows you to associate any number of access rules with specific security roles to group related permissions together. To associate an access rule with a security role, assign the role’s name to the rule’s FileManagerAccessRuleBase.Role property.

Any created role can be enforced on the ASPxFileManager via its Role property. After that, the file manager will display the folder and files and provide access permissions to them based on the assigned role.

Concept

Online Demo

Example

ASPX

aspx

<dx:ASPxRadioButtonList ID="rblRole" runat="server" AutoPostBack="true" SelectedIndex="0" OnValueChanged="rblRole_ValueChanged">
        <Items>
            <dx:ListEditItem Text="Default User" Value="" Selected="True" />
            <dx:ListEditItem Text="Document Manager" Value="DocumentManager" />
            <dx:ListEditItem Text="Media Moderator" Value="MediaModerator" />
            <dx:ListEditItem Text="Administrator" Value="Administrator" />
        </Items>
</dx:ASPxRadioButtonList>

<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" Edit="Allow" Browse="Allow" />
          </AccessRules>
     </SettingsPermissions>
</dx:ASPxFileManager>

C#
VB.NET

csharp

protected void rblRole_ValueChanged(object sender, EventArgs e) {
     FileManager.SettingsPermissions.Role = (string)rblRole.Value;
}

Protected Sub rblRole_ValueChanged(ByVal sender As Object, ByVal e As EventArgs)
     FileManager.SettingsPermissions.Role = CStr(rblRole.Value)
End Sub