All docs
V21.1
21.2 (EAP/Beta)
21.1
20.2
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.

How to: Load and Save Password-Encrypted PDF Documents

  • 5 minutes to read

The following example describes how to open and save password-encrypted PDF documents; it also lists supported encryption and operation restriction settings.

Open a Password-Encrypted Document

Handle the PdfViewerControl.GetDocumentPassword event to manage the password request when the PDF Viewer tries to open the protected document. You can specify the password as a GetDocumentPasswordEventArgs.Password property. As a result, the password request dialog is not displayed.

private void PdfViewer_GetDocumentPassword(DependencyObject d, GetDocumentPasswordEventArgs e)
{
    SecureString password = new SecureString();
    password.AppendChar('1');
    password.AppendChar('2');
    password.AppendChar('3');

    e.Password = password;
    e.Handled = true;
}

Specify the PdfViewerControl.PasswordAttemptsLimit property to limit the number of attempts to enter a password. Use the GetDocumentPasswordEventArgs.PasswordRequestsCount property to check the number of attempts. If the GetDocumentPassword event is handled and the user reaches the limit of attempts, the PDF Viewer shows an error message.

Encrypt a Document with a Password

Call the PdfViewerExtensions.SaveDocument extension method to encrypt a document and save it. Use the PdfSaveOptions class properties to specify the encryption algorithm, operation restriction settings, and passwords.

Important

The PdfViewerExtensions class is defined in the DevExpress.Docs.v21.1.dll assembly. Add this assembly to your project to use extensions. You need an active license for the DevExpress Office File API Subscription or DevExpress Universal Subscription to use this assembly in production code.

The code sample below specifies encryption settings and saves the document:

public MainWindow()
{
    pdfViewer.OpenDocument("Document.pdf");
    pdfViewer.DocumentLoaded += PdfViewer_DocumentLoaded;
}

private void PdfViewer_DocumentLoaded(object sender, RoutedEventArgs e)
{
    PdfEncryptionOptions encryptionOptions = new PdfEncryptionOptions();

    // Specify the encryption algorithm:
    encryptionOptions.Algorithm = PdfEncryptionAlgorithm.AES256;

    // Set the owner and user passwords:
    encryptionOptions.OwnerPasswordString = "123";
    encryptionOptions.UserPasswordString = "456";

    // Save the document:
    pdfViewer.SaveDocument("Protected.pdf", new PdfSaveOptions
        { EncryptionOptions = encryptionOptions });
}

Encryption Passwords

You can encrypt a document with two passwords: user and owner. The user password prevents unauthorized access to a document. If a document is opened with a user password or without a password (if the user password is not specified), you can perform only permitted operations with a document. The owner password opens the document without restrictions.

Use the OwnerPasswordString and UserPasswordString properties to specify passwords. Take into account the following when you set passwords:

  • If the owner and user passwords match, or only the user password is specified, a user should only specify the password to get unrestricted access to the document.
  • The specified operation restrictions have no effect without the owner password.

Note

The PDF Viewer ignores the operation restrictions, so you can enter any of the two passwords to get full access to the document. However, the OwnerPasswordString and UserPasswordString properties are saved in a document, so that the restrictions are applied when the document is opened in other PDF viewer applications.

Restrict Document Operations

You can encrypt a document with a password and restrict data extraction, data modification, interactive, or printing operations.

The table below lists properties used to specify operation restrictions, and supported values:

Restriction Property Values
Printing Restrictions PrintingPermissions Allowed – allows users to print the document.
LowQuality – allows users to print the document at the low quality level.
NotAllowed – prohibits document print operation.
Data Extraction Restrictions DataExtractionPermissions Allowed – allows users access all data extraction operations (copy content, extract text, or graphics from a document), including access to software that uses assistive technologies.
Accessibility – allows users to access document content only through assistive technologies.
NotAllowed – prohibits all data extraction operations.
Modification Restrictions ModificationPermissions Allowed – allows users to modify and assemble a document: insert, rotate, and delete pages; create bookmarks and thumbnails.
DocumentAssembling – allows users to only assemble a document.
NotAllowed – prohibits document modification.
Interactivity Restrictions InteractivityPermissions Allowed – allows users access to all interactive operations: to add or modify text annotations, fill in interactive form fields, and create or modify interactive form fields.
FormFillingAndSigning – allows users to only fill in existing form fields and sign the document.
NotAllowed – prohibits all interactive operations.

Note

The PDF Viewer ignores all permission properties. However, these settings are saved in a document, so that the restrictions are applied when the document is opened in other PDF viewer applications.

The code sample below applies operation restrictions and encrypts the document:

private void PdfViewer_DocumentLoaded(object sender, RoutedEventArgs e)
{
    PdfEncryptionOptions encryptionOptions = new PdfEncryptionOptions();

    // Specify the encryption algorithm:
    encryptionOptions.Algorithm = PdfEncryptionAlgorithm.AES256;

    // Set the operation restrictions:
    encryptionOptions.ModificationPermissions = PdfDocumentModificationPermissions.NotAllowed;
    encryptionOptions.DataExtractionPermissions = PdfDocumentDataExtractionPermissions.NotAllowed;
    encryptionOptions.InteractivityPermissions = PdfDocumentInteractivityPermissions.FormFillingAndSigning;

    // Set the passwords:
    encryptionOptions.OwnerPasswordString = "123";
    encryptionOptions.UserPasswordString = "456";

    // Save the result:
    pdfViewer.SaveDocument("Protected.pdf", new PdfSaveOptions
        { EncryptionOptions = encryptionOptions });
}