Log In
[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]Document Server
 [Expand]Product Information
 [Collapse]Creating Reports in Visual Studio
  [Expand]Adding a Report to Your .NET Application
  [Collapse]Getting Started with DevExpress Reporting
   [Collapse]Quick Tour of Visual Studio Report Designer
     First Look at the Report Designer
     Introduction to Banded Reports
     Adding Contents to a Report
     Manipulating Report Elements
     Laying Out Dynamic Report Contents
   [Expand]Creating a Report from A to Z
   [Expand]Creating Popular Reports
  [Expand]Detailed Guide to DevExpress Reporting
  [Expand]Detailed Guide to Visual Studio Report Designer
 [Expand]Creating End-User Reporting Applications
 [Expand]API Reference
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

First Look at the Report Designer

This topic provides an overview of the report editing surface where you can customize your reports at design time within Visual Studio.


See Adding a Report to Your .NET Application to learn about integrating DevExpress reports into your desktop or web/mobile applications created within Visual Studio.

Whatever application platform you choose, the created reports are platform-agnostic, and you can re-use them in other applications targeting different platforms.

When adding a new report to your application, Visual Studio displays the Report Wizard prompting you to select the type of report you want to create:

  • Empty Report
    Creates a new blank report that is not bound to a data source, and finishes the wizard. Choose this option to design your report without using the wizard.

  • Data-bound Report
    Allows you to proceed with the wizard, connect the created report to a data source and configure basic report layout settings (optional).

  • Template Report
    Enables you to create a new report based on available predefined templates.

  • Label Report
    Runs the label wizard enabling you to create labels, badges or price tags by selecting from hundreds of customizable layouts.

Closing the wizard adds a new XtraReport class to your application and opens the created report in the integrated Report Designer:

When loading the Report Designer, you can see the report editing surface displaying a report's structure and contents.

When creating a blank report, this surface displays the top and bottom page margins along with an empty detail band (by default).


You can make your report display different content by adding other controls to report bands.

See Introduction to Banded Reports for basic information about report bands.

You can change the default zoom factor of the Report Designer using the zoom panel:

While designing a report, you can preview the resulting document by switching to the Preview tab below a report's design surface:

This opens a Print Preview, fills a report's data source and generates the report document's pages.

Switching to HTML View displays a published web report document's HTML layout.

Switching to the Scripts tab enables you to manage and customize report scripts.


See Detailed Guide to Visual Studio Report Designer to learn more about the Visual Studio Report Designer's toolbox and dock panels.

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