[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Getting Started
     ASPxRichEdit Control
     [Collapse]Document Model
       Text Content (Text Buffer)
       Inline Pictures
       Hyperlinks and Bookmarks
       Headers and Footers
       Document Fields
       Floating Objects
       Document Protection
      Document Layout
     Supported Document Formats
     Import and Export
     Print Documents
     Formatting Characters
     Formatting Paragraphs
     Mail Merge
     Simple View
     Table of Contents
     Spell Checking
    [Expand]Client API
    [Expand]Built-in Dialogs
     HTML Tag Interpretation
     Keyboard Shortcuts
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Document Protection

Expanded Overview

The document protection sets rules on the editing of particular documents. Users cannot modify a protected document. However, this document type may include range permissions that authorize a user (or a user group) to edit a specific text area. You can apply protection and range permissions to a document using Microsoft Word or Rich Edit Document Server.

Users can use the ASPxRichEdit to open and view protected documents. The control allows you to identify the current user to enable ranges permitted for the specified user or group. Editable ranges can be enclosed in brackets and highlighted, as illustrated in the following image:


Users and groups range permissions are not compatible with Microsoft Word's Editing Restrictions. Only the predefined groups are saved in RTF format; group names are not saved in DOC format.

Expanded Authentication Settings

A protected document may include range permissions granted to a unique user or a user group. These permissions require a user's credentials to authorize editing of ranges. The ASPxRichEdit control includes the ASPxRichEditSettings.Authentication property that allows you to identify a current user's credentials and enable separate text areas (or entire document) for editing. This property provides access to the ASPxRichEditAuthenticationSettings object containing the following user's credentials:

The control authorizes editing of range if one of the user's credentials meets the range permission's requirements.

Note, that if a protected document includes a range permitted for a user group named Everyone, every user can edit this text area even if the ASPxRichEditSettings.Authentication settings are not defined.

The code snippet below demonstrates an ASPxRichEdit class instance with the specified authentication settings:

Expanded Appearance Settings

The ASPxRichEdit control allows you to highlight text ranges that the current user can edit in the protected document. The ASPxRichEditSettings.RangePermissions property stores the ASPxRichEditRangePermissionSettings class's instance that allows you to specify the following settings:

The following code snippet demonstrates an ASPxRichEdit class instance with the specified range permissions options:

Expanded See Also

Is this topic helpful?​​​​​​​