Loading Encrypted Files

Some file formats (DOC, DOCX, PDF, PPT, PPTX, XLS, XLSX, etc) can be encrypted using a password. These files will be loaded properly only if your application provides a decryption password.

The decryption password for all formats is provided through the RasterCodecs.Options.Load.Decrypt.Password property or through the RasterCodecs.DecryptPassword event.

In addition, the decryption password for PDF files can also be provided using the RasterCodecs.Options.PDF.Load.Password property.

If the password provided through the RasterCodecs.DecryptPassword event handler is not valid, the event will be fired again until one of the following happens:

• The RasterCodecs.DecryptPassword event handler provides the correct password.
• The event handler cancels the operation gracefully by setting the CodecsDecryptPasswordEventArgs.Cancel property to true. In this case, the operation will fail without throwing an exception. Refer to RasterCodecs.DecryptPassword for more information on how the operation is aborted in this case.

It is important to be careful and avoid going into an infinite loop. If you use an event handler that returns the same password each time and the password is incorrect, your application will lock up because the event will keep getting fired until you kill the app.

If you are loading files indirectly using the Document Library, refer to Loading Encrypted Files Using The Document Library.

Related Topics