[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
   [Collapse]Use Charts and Pivot Grids
     Use Charts in Reports
     Add a Chart (Set Up Series Manually)
     Add a Chart (Use a Series Template)
     Use Charts to Visualize Data in Report Groups
     Link a Chart and a Pivot Grid
   [Expand]Use Gauges and Sparklines
   [Expand]Drawing Lines and Shapes
   [Expand]Using 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)

Use Charts in Reports

This topic describes how to embed a chart into a report.

Expanded Chart Overview

You can use the XRChart control to add a chart to a report. This control provides 2D or 3D views to visualize data series.

2D Series View 3D Series View

The XRChart control can display multiple series.

Bar and Point Series Nested Doughnut Series

The XRChart control contains various visual elements (diagrams, series, legends, primary and secondary axes, titles and labels, etc.). You can select these elements in the Report Designer and customize their settings in the Property Grid. Refer to the XRChart class description in the API Reference documentation section for more information on these settings.

The desktop and web End-User Report Designer versions provide the Chart Designer that allow end users to create and customize charts.

You can use the XRChart control in reports only. Use the following controls to embed charts elsewhere in your application:

Platform Chart Control Class Documentation
ASP.NET WebChartControl Chart Control (ASP.NET)
Windows Forms ChartControl Chart Control (WinForms)
WPF ChartControl and Chart3DControl Charts Suite (WPF)

The XRChart control is implemented the same way as the chart controls listed in the table above. Refer to these controls' documentation for information about possible chart configurations and the XRChart class's description for instructions on how to apply these configurations in reports.

Expanded Bind a Chart to Data

To bind data to a chart, use the XRChart.DataSource property.


You can assign a Pivot Grid to a chart's data source. This allows the XRPivotGrid to supply data to the chart. Refer to the Link a Chart and a Pivot Grid topic for details.

When the chart data source is not assigned, the chart obtains data from the report's data source (assigned to the XtraReportBase.DataSource property). A chart can display report data in the following ways:

  • Place a chart on the report header/footer band to display a summary for the detail report data.

  • The chart in the Detail band is printed as many times as there are records in the report's data source. You can use a custom progress bar control instead of the chart control to visualize report detail data.

Specify the following settings to provide data to a chart's series.

You can specify these settings in the following ways:

The data members assigned to the series argument and values should match the data types that the SeriesBase.ArgumentScaleType and SeriesBase.ValueScaleType properties specify.


See the WinForms Charts Documentation to learn more about a chart's configuration.

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