Skip to main content
All docs

Create a Report with a Visual PDF Signature

  • 2 minutes to read

This tutorial describes how to create a report with a visual PDF signature.


To get started with this tutorial, create a new project or open an existing project, then add a new blank report to the project.

Create a Report Layout

  1. Drop the XRRichText control from the DX.23.1: Report Controls Toolbox tab onto the Detail band.

  2. Double-click the control and insert text of the DevExpress Website Terms of Use.

  3. Right-click the design surface. Select Insert Band / ReportFooter from the context menu. Enable the footer band‘s PrintAtBottom property.

  4. Drop the XRPdfSignature control from the DX.23.1: Report Controls Toolbox tab onto the Report Footer band.

  5. Place the XRLabel control to the left of the XRPdfSignature and add the following text: I have read and accept this Website Terms of Use statement.

Click the Preview tab to see the result.

Export and Sign the Report

  1. In Preview, click Export Document and select PDF File.

  2. In the invoked PDF Export Options dialog, click the Digital Signature option’s ellipsis button.

  3. In the invoked Signature Options dialog, choose a certificate and specify signature details.

Save and open the document to see the final result.


All signature fields are displayed in the exported document. You can also hide unnecessary fields. See the XRPdfSignature control’s description for details on how to configure the fields.

To sign the exported PDF document in the Web Document Viewer, use one of the following options:

Sign the document in the Web Document Viewer’s UI
Implement the IPdfSignatureOptionsProviderAsync interface to register available signature options. Select a signature from the Signature drop-down list in the Export to PDF section.
Customize the exported document
Override the CustomizeExportDocumentOnFinish method to retrieve and sign the exported document.

The following example shows how to sign a document exported to PDF:

View Example: How to Sign the Exported PDF Document

PDF Signature Control Limitation

  • The XRPdfSignature control is not exported to non-PDF formats. A placeholder is added to exported documents instead.


Tutorials that explain how to create different reports using Web Report Designer are included in the End-User Documentation online help section.