A newer version of this page is available. Switch to the current version.

Create an ASP.NET Web Forms Application with a Report Designer

  • 3 minutes to read

This tutorial describes how to use the DevExpress Template Gallery to generate a basic ASP.NET Web Forms application that contains an End-User Report Designer.

  1. To create a new project, select FILE | New | Project in the main menu (or press CTRL+SHIFT+N).

    create-new-application-windows-forms

  2. In the invoked New Project dialog, expand the Installed category, select a programming language (Visual C# or Visual Basic), and select the DevExpress v20.2 Template Gallery.

    asp-net-mvc-reports-create-devexpress-template-gallery

    Specify the application name and click OK.

  3. Select Reporting Web Application from the ASP.NET WebForms category in the invoked DevExpress Template Gallery and click Run Wizard.

    web-template-gallery-reporting-application

  4. Enable the Add Designer Page checkbox on the Reporting Control Settings wizard page to add a Report Designer to the web application.

    Tip

    You can add a Web Document Viewer and a Report Designer to the application.

    web-reporting-project-wizard-select-designer

    Use the following Report Designer settings:

    Add Report Storage
    Specifies whether to create a sample server-side report storage. This storage allows you to open report layout files (REPX) from the Reports folder and instances of report types predefined in the assembly. In Visual Studio, you can customize any reports included in the assembly. If you modified a report in the Web Report Designer, it is saved to the corresponding REPX file in the Reports folder.

    Note

    The template generates a sample storage (a ReportStorageWebExtension descendant) for demonstration purposes only. Create your own implementation for use in production.

    Report Storage Name
    Specifies the report storage class name.
    Session State
    Specifies the type of session support to handle requests. Choose Required to enable the Report Designer to access values stored in HttpContext.Session.
    Data Binding Mode
    Specifies the data fetch mode for report controls. You can switch between legacy binding mode and expression bindings.
    Log Errors and Events
    Specifies whether to log server-side errors and events related to the Report Designer functionality to a particular file.
    Add Sample Database
    Specifies whether to create a sample connection string and register it in the Report Designer to create SQL Data Sources in the Report Wizard and Data Source Wizard. The connection string is also used to register a predefined data source.
    Add Sample JSON Data Connection Storage
    Specifies whether to create a storage and register it to create JSON Data Sources in the Report Wizard and Data Source Wizard. For the storage to work correctly, set the Session State setting to Required and ensure that the Newtosoft.Json package is installed.
    Add Sample Data Object
    Specifies whether to add a sample data object to an application and register this data object to create Object Data Sources in the Report Wizard and Data Source Wizard.
    Enable Rich Text Editor
    Specifies whether to add an in-line Rich Text Editor for the RichText control.

    Click Create Project to apply these settings to the project.

See Also