[Expand]General Information
[Expand]WinForms Controls
[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]Product Information
 [Expand]Get Started with DevExpress Reporting
 [Expand]Create Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Provide Data to Reports
  [Collapse]Use Report Controls
    Add Controls to a Report
    Manipulate Report Controls
    Use Basic Report Controls
   [Expand]Use Tables
   [Expand]Use Bar Codes
   [Expand]Use Charts and Pivot Grids
   [Expand]Use Gauges and Sparklines
   [Expand]Draw Lines and Shapes
   [Expand]Use Custom and Third-Party Controls
  [Expand]Shape Report Data
   Arrange Dynamic Report Contents
  [Expand]Customize Appearance
  [Expand]Add Navigation
  [Expand]Provide Interactivity
  [Expand]Add Extra Information
  [Expand]Merge Reports
  [Expand]Use Expressions
  [Expand]Store and Distribute Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Create End-User Reporting Applications
 [Expand]API Reference
[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)

Add Controls to a Report

This document describes how to add controls to a report.

Expanded Add Controls from the Toolbox

Use the DX.19.1: Report Controls tab in Visual Studio's Toolbox to add controls to your report.


If you don't see Report Controls on the Toolbox, see How to resolve issues with Toolbox items for more information.

Expanded Add Data-Bound Controls from the Field List

You can drag fields from the Field List onto your report to add data-bound controls, after you bound your report to a datasource.

Add a Control

Drag a field from the Field List and drop it onto the report's surface.

To add a control of specific type, do either of the following:

  • Hold down the SHIFT key and drop a data field onto a report's surface.
  • Right-click a data field and drop it onto a report's surface.

This invokes a context menu where you can select which control to add.

Add a Table

Hold the CTRL or SHIFT key and click several fields. Drop them onto the report's surface to add a table with its cells bound to these fields.

Drop an entire data table from the Field List to add a report table with columns bound to the data table's fields.

To add column headers, do either of the following:

  • Select the fields and hold the CTRL or SHIFT key when you drop them onto a report surface.
  • Drag and drop fields with the right mouse button.

This adds a new table whose cells display the field names.

Expanded Add Content from External Sources

You can add text and graphics from external applications to your reports:

  • Drag a file, text or image from an external application onto your report.

  • Copy a file, text or image from an external application, and paste it into your report.

The following table shows which file types transform into report controls:

File Type



An XRLabel control that contains file contents.


An XRRichText control that contains file content.


An XRPictureBox control that contains the image.

Expanded See Also

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