Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Collapse]Rich Text Editor
   [Expand]Product Information
   [Collapse]Concepts
     ASPxRichEdit Control
    [Collapse]Document
     [Collapse]Document Model
       Sub-Document
       Text Content (Text Buffer)
       Characters
       Paragraphs
       Inline Pictures
       Hyperlinks and Bookmarks
       Tables
       Sections
       Headers and Footers
       Document Fields
       Floating Objects
       Document Protection
      Document Layout
     Supported Document Formats
     Import and Export
     Formatting Characters
     Formatting Paragraphs
    [Expand]Fields
     Mail Merge
     Restrictions
     Spell Checking
    [Expand]Client API
    [Expand]Built-in Dialogs
     HTML Tag Interpretation
     Keyboard Shortcuts
   [Expand]Examples
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]Scheduler
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gauges
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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:

Note

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

How would you rate this topic?​​​​​​​