Log In
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
 [Expand]Product Information
 [Expand]Getting Started
 [Expand]Fundamental Concepts
  [Expand]Report Types
  [Collapse]Report Controls
   [Expand]Bar Code
    Character Comb
    Check Box
    Cross-Band Controls
   [Expand]Custom Controls
    Page Break
    Page Info
    Picture Box
    Pivot Grid
    Rich Text
    Table of Contents
   [Expand]Third Party Controls
    Zip Code
  [Expand]Platform-Specific Reporting
  [Expand]Creating Reports
  [Expand]Storing Reports
  [Expand]Publishing Reports
  [Expand]End-User Reporting
  [Expand]Application Appearance
  [Expand]Migration to XtraReports
 [Expand]Design-Time Features
  End-User Capabilities
 [Expand]Redistribution and Deployment
 [Expand]API Reference
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation


This topic provides the most important information you need to consider when embedding a chart into a report:

Expanded Chart Overview

The XRChart control can only be used in reports. To use similar charts elsewhere in your application, use the following controls.

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 chart enables you to visualize series of points using 2D or 3D views.

2D Series View

3D Series View

A chart can display multiple series having compatible views.

Bar and Point Series

Nested Doughnut Series

A chart contains various visual elements (such as diagrams, series, legends, primary and secondary axes, titles and labels). You can select these elements in the Report Designer and customize their settings in the Property Grid.

Expanded Chart Designer

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

Expanded Bind a Chart to Data

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

You can assign a Pivot Grid to a chart's data source, allowing the XRPivotGrid to supply data to the chart. To learn more about this feature, see Pivot Charting.

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 located in a DetailReportBand obtains its data from the detail report's data source.

In most scenarios, you need to locate a chart on the report header/footer band to display a summary for the detail report data.

When placing a chart onto a group header/footer, use the XRDataFilter.ValueBinding property to allow the chart to visualize data in each report group. For a step-by-step tutorial, see How to: Use Charts to Visualize Data in Report Groups.

Placing a chart onto the Detail band allows the chart to be printed as many times as there are records in the report's data source. Consider using a custom progress bar control instead of the chart control to visualize report detail data.

To provide data to a chart's series, specify the following settings.

Depending on whether or not you create series manually, you can specify these settings in the following ways.

The data members assigned to the series argument and values must match the data types specified by the SeriesBase.ArgumentScaleType and SeriesBase.ValueScaleType properties.

To learn more about using charts, see the WinForms Charts Documentation.

Expanded See Also

How would you rate this topic?​​​​​​​