SpreadsheetControl.EncryptedFilePasswordCheckFailed Event
Occurs when the encryption password is empty or invalid.
Namespace: DevExpress.XtraSpreadsheet
Assembly: DevExpress.XtraSpreadsheet.v24.1.dll
NuGet Package: DevExpress.Win.Spreadsheet
Declaration
public event EncryptedFilePasswordCheckFailedEventHandler EncryptedFilePasswordCheckFailedEvent Data
The EncryptedFilePasswordCheckFailed event's data class is EncryptedFilePasswordCheckFailedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| DocumentName | Gets the encrypted document’s name. |
| Error | Obtains the password error. |
| Handled | Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. Inherited from HandledEventArgs. |
| TryAgain | Gets or sets whether to request a password again. |
Remarks
Hanlde the EncryptedFilePasswordCheckFailed event to determine the password error (PasswordRequired or WrongPassword), and specify whether to enable a new password request (TryAgain).
If the TryAgain property is set to true, the EncryptedFilePasswordRequest event occurs. The ISpreadsheetComponent.InvalidFormatException event fires when the TryAgain property is not specifies or set to false.