PdfViewer.PasswordRequested Event

Occurs when requesting a security password to open a protected PDF file.

Namespace: DevExpress.XtraPdfViewer

Assembly: DevExpress.XtraPdfViewer.v18.2.dll

Declaration

C#

public event PdfPasswordRequestedEventHandler PasswordRequested

VB.NET

Public Event PasswordRequested As PdfPasswordRequestedEventHandler

Event Data

The PasswordRequested event's data class is PdfPasswordRequestedEventArgs. The following properties provide information specific to this event:

Property	Description
FileName	Returns the file name of a document that is requested to be opened in the PDF Viewer or PDF Document Processor.
Password	Obsolete. This property is now obsolete. Use the PdfPasswordRequestedEventArgs.PasswordString property instead.
PasswordRequestsCount	Returns the current number of password request attempts.
PasswordString	Specifies the security password to open a PDF file.

Remarks

To interrupt the password request process, the PdfPasswordRequestedEventArgs.PasswordString property value should be set to null.

To change the maximum number of allowed attempts to enter the PDF file’s security password, use the PdfViewer.PasswordAttemptsLimit property (the default value is 1).

Example

The following code illustrates the use of the PdfViewer.PasswordRequested event.

C#

using System.Windows.Forms;
using DevExpress.Pdf;
// ...

private void pdfViewer1_PasswordRequested(object sender,
    PdfPasswordRequestedEventArgs e) {
    e.PasswordString = "password";    
}

VB.NET

Imports System.Windows.Forms
Imports DevExpress.Pdf
' ...

Private Sub pdfViewer1_PasswordRequested(ByVal sender As Object, _
ByVal e As PdfPasswordRequestedEventArgs) Handles pdfViewer1.PasswordRequested
    e.PasswordString = "password"   
End Sub