[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]Getting Started with DevExpress Reporting
 [Expand]Creating Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Providing Data to Reports
  [Collapse]Using Report Controls
    Adding Controls to a Report
    Manipulating Report Controls
   [Expand]Using Basic Report Controls
   [Expand]Using Tables
   [Expand]Using Bar Codes
   [Expand]Using Charts and Pivot Grids
   [Expand]Using Gauges and Sparklines
   [Expand]Drawing Lines and Shapes
   [Expand]Using Custom and Third-Party Controls
  [Expand]Shaping Report Data
   Laying out Dynamic Report Contents
  [Expand]Customizing Appearance
  [Expand]Adding Navigation
  [Expand]Providing Interactivity
  [Expand]Adding Customary Information
  [Expand]Merging Reports
  [Expand]Using Expressions
  [Expand]Storing and Distributing Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
This documentation page describes implementations made in our v17.2 release cycle. To learn about functionality shipping with v18.1, navigate to our updated help file experience at docs.devexpress.com. Learn More

Adding Controls to a Report

After connecting a report to a data source (and optionally, shaping the incoming data using the Query Builder), you need to include this data in a report.

Expanded Adding Report Controls

The easiest way to list data source content in your report is to drag a corresponding entity from the Field List and drop it onto the report's detail band. Dropping a field onto a report's surface creates a new report control bound to the corresponding field.

You can add other controls to your report using the Visual Studio Toolbox. Its DX.18.1: Report Controls tab contains report elements that you can add to a report for displaying various types of content, such as text, images, charts or barcodes.


On rare occasions, the installation does not add the corresponding tabs to the Toolbox correctly.

See How to resolve issues with Toolbox items if you come across this issue.

This document describes how to add the most commonly used controls to a report. See Using Report Controls for a complete list of available controls.

Expanded Displaying Text

Use the following controls to display text in a report:

  • XRLabel
    Displays plain text in a report. You can customize the font settings for a label's entire content only.

  • XRRichText
    Displays rich text in a report. You can assign different font settings to any part of the control's contents and load contents from an external RTF file.

  • XRTable
    Contains any number of XRTableCell controls arranged in one or more rows. Each table cell can display plain text or contain other controls.

  • XRCharacterComb
    Displays each character in a separate cell, which is useful when creating printed forms.

Double-clicking any of these controls invokes an in-place editor where you can enter text and format it.

Use the corresponding toolbar for quick access to a selected element's font settings.


You can open this toolbar by selecting View | Toolbars | XtraReports if it is missing in Visual Studio.

Labels and other text-oriented controls can display the following types of content:

  • Static content

    Once you specified a control's content, it never changes in a published document.

  • Dynamic content

    This content is supplied from a connected data source. In a published document, it changes according to the printed data source record.

    You can format dynamic content using a control's smart tag.

  • Mixed content

    For labels and other text-oriented controls, you can combine the static and dynamic content within the same control.

    With the in-place editor, you can refer to data source fields by enclosing them into square brackets.

    You can format a data field's value by selecting the field in the in-place editor and accessing the Format String editor via the control's smart tag.

Expanded Displaying Page Numbers

Use the XRPageInfo control to display information about document pages, such as the current page number and/or total number of pages.

You can use this control to add information about a report's author and the document creation date.

See the following tutorials for detailed instructions:

Expanded Displaying Check Boxes, Images and Bar Codes

Dropping a Boolean data field from the Field List onto a report creates an XRCheckBox control bound to that field.

Checkboxes can display different states depending on the underlying data values.

Use the XRPictureBox control to display images in a report. You can load an image from an external file or bind this control to a binary data source field.

To display barcodes, use the XRBarCode control.

Expanded Drawing Lines and Shapes

Use the XRShape control to draw simple graphics in a report, such as circles, crosses or arrows.

The XRLine control enables you to draw straight or slanted lines within a single band.

The following controls enable you to draw lines and boxes spanning multiple report bands:

Expanded See Also

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