[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Collapse]PDF Viewer
   [Expand]Getting Started
    Coordinate Systems
   [Collapse]Access and Edit Document Content
    [Expand]Interactive Forms
     File Attachment
     Text Markup Annotations
     Content Copying
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

File Attachment

This document introduces the file attachment feature and describes actions that can be performed on attachments in the PDF Viewer.

The document consists of the following sections:

Expanded Overview

An attachment is a file that is attached to a PDF document. The PDF Viewer displays the attachments in the Attachments panel of the Navigation Pane.


Use the PDF Document API if you wish to generate a PDF document and attach a file to it. For more information, see the How to: Attach a File to a Document example.

The Attachments panel can contain multiple attachments in any format (that is, images, text files, PDFs).

Expanded Open an attachment

You need to have an application supporting the corresponding file format on your computer to open a file attachment. To view an attachment, do one of the following:

  • double-click the attached file;


  • select the file and click the "Open file in its native application" button in the Attachments panel.

The Security Warning message appears. It warns you that the PDF Viewer will use an external application to open the attached file.

Click Yes to open the attached file, otherwise click No.

The image below shows the "player.png" image that was opened in the Photos application.

You can customize the attachment opening behavior (that is, to hide the Security Warning message box) by handling the PdfViewer.FileAttachmentOpening event.

Expanded Save an attachment

To save attachments to your disk, select the file and click the "Save attachment" button, as shown below.

The Save As dialog appears.

Choose the file attachment location on the disk, specify the file name, and click Save.

You can also customize a navigation pane where the Attachments button is located. For more information, refer to the Navigation Pane document.

Expanded See Also

Is this topic helpful?​​​​​​​