FileManagerSettingsPermissions.Role Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

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

VB.NET

<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:

Show 21 property paths

Library	Object Type	Path to Role
ASP.NET Bootstrap Controls	BootstrapFileManager	.SettingsPermissions.Role
ASP.NET Web Forms Controls	ASPxFileManager	.SettingsPermissions.Role
	HtmlEditorAudioSelectorSettings	.PermissionSettings.Role
	HtmlEditorDocumentSelectorSettings	.PermissionSettings.Role
	HtmlEditorFileManager	.SettingsPermissions.Role
	HtmlEditorFileManagerSettingsBase	.PermissionSettings.Role
	HtmlEditorFlashSelectorSettings	.PermissionSettings.Role
	HtmlEditorImageSelectorSettings	.PermissionSettings.Role
	HtmlEditorSelectorSettings	.PermissionSettings.Role
	HtmlEditorVideoSelectorSettings	.PermissionSettings.Role
	RichEditDocumentSelectorSettings	.PermissionSettings.Role
	RichEditFileManager	.SettingsPermissions.Role
	RichEditFolderManager	.SettingsPermissions.Role
	SpreadsheetDocumentSelectorSettings	.PermissionSettings.Role
	FileManagerSettings	.SettingsPermissions.Role
	MVCxFileManager	.SettingsPermissions.Role
	MVCxHtmlEditorAudioSelectorSettings	.PermissionSettings.Role
	MVCxHtmlEditorDocumentSelectorSettings	.PermissionSettings.Role
	MVCxHtmlEditorFlashSelectorSettings	.PermissionSettings.Role
	MVCxHtmlEditorImageSelectorSettings	.PermissionSettings.Role
	MVCxHtmlEditorVideoSelectorSettings	.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

• Access Control (WebForms)

• Access Control (MVC)

Online Demo

• ASPxFileManager - Access Control (Web Forms)

• FileManager - Access Control (MVC)

Example

C#

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

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 Path="*.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>