SecurityOptions Property

public PDFSecurityOptions SecurityOptions {get; set;}

'Declaration
 
Public Property SecurityOptions As PDFSecurityOptions

'Usage
 
Dim instance As PDFFile
Dim value As PDFSecurityOptions
 
instance.SecurityOptions = value
 
value = instance.SecurityOptions

public PDFSecurityOptions SecurityOptions {get; set;}

 get_SecurityOptions();
 set_SecurityOptions(value);  

public:
property PDFSecurityOptions^ SecurityOptions {
   PDFSecurityOptions^ get();
   void set (    PDFSecurityOptions^ value);
}

Property Value

The following methods of the PDFFile class will use the secutity options set in .SecurityOptions when updating or creating a PDF file:

• Convert
• Distill
• MergeWith
• ExtractPages
• DeletePages
• InsertPagesFrom
• ReplacePagesFrom

If the value of SecurityOptions is null (Nothing in Visual Basic), then the PDFFile will not encrypt the result PDF file.

There are two different ways to protect a PDF file with a password:

• By using a user password set in UserPassword. In this mode, external viewers such as Adobe Acrobat will ask the user for the same password when opening the file for viewing. If the correct password is supplied, then all operations and rights are granted.

• By using an owner password set in OwnerPassword. In this mode, external viewers such as Adobe Acrobat will ask the user for the same password when opening the file for viewing. If the correct password is supplied, the editor will check the various access rights properties to allow or disallow certain operations on the PDF file such as printing or editing.

You cannot use both UserPassword and OwnerPassword in the same PDF file. If both values are set, then the PDFFile object will use OwnerPassword and ignore UserPassword.

Similar to the DocumentProperties property, the value of SecurityOptions will not be modified when a PDF file is loaded in this object using the Load method.

To check if a PDF file is encrypted and requires a password to view or modify, use the IsEncrypted method.

For an example, refer to PDFSecurityOptions.

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

PDFFile Class
PDFFile Members