ActiveReports 18 .NET Edition
Developers / Quick Start
In This Topic
    Quick Start
    In This Topic

    Quickly begin using ActiveReports by following the steps below. 

    1. Install ActiveReports.     

    2. In Microsoft Visual Studio 2022 (version 17.0 or above), select ActiveReports 18 ASP.NET Core MVC Application template and click Next.
      Create new project in Visual Studio
      For complete list of built-in templates, see the Project Templates topic.

    3. Type a name for your project and click Create.
      Configure Visual Studio new project

    4. Select RDLX from report types and click Finish:
      • RDLX
      • RDLX Dashboard
      • Page
      • Section
        Check Report Types topic that will help you choose a report type.
    5. Open the default 'Report.rdlx' report from the 'Reports' folder and design. You can also choose to add report types from the context menu of the 'Reports' folder.
    6. Make sure to set the Build Action property of the report to 'Embedded resource'.
    7. Modify index.cshtml to provide the name of the report you want to preview in viewer.openReport() method:

      The complete index.cshtml looks as below.

      Copy Code
      <!DOCTYPE html>
      <html lang="en">
          <meta charset="utf-8">
          <link rel='shortcut icon' type='image/x-icon' href='favicon.ico' />
          <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
          <meta name="theme-color" content="#000000">
          <title>JS Viewer</title>
          <link href="~/jsViewer.min.css" rel="stylesheet">
          <link href="~/index.css" rel="stylesheet">
      <body onload="loadViewer()">
          <div style="width: 100%; overflow-x: hidden">
              <div style="float:right;width:100%" id="viewerContainer">
          <script type="text/javascript" src="~/jsViewer.min.js"></script>
          <script type="text/javascript">
              let viewer;
              function loadViewer() {
                  viewer = GrapeCity.ActiveReports.JSViewer.create({
                      element: '#viewerContainer'

      In Startup.cs, the root directory containing the report is resolved using config.UseFileStore(rootDir). The complete Startup.cs looks like below.

      Copy Code
      using GrapeCity.ActiveReports.Aspnetcore.Viewer;
      using Microsoft.AspNetCore.Builder;
      using Microsoft.AspNetCore.Hosting;
      using Microsoft.Extensions.DependencyInjection;
      using Microsoft.Extensions.Hosting;
      using Microsoft.Extensions.Logging;
      using System;
      using System.IO;
      namespace ActiveReportsCoreMVCApplication
          public class Startup
              // This method gets called by the runtime. Use this method to add services to the container.
              public void ConfigureServices(IServiceCollection services)
                      .AddLogging(config =>
                          // Disable the default logging configuration
                          // Enable logging for debug mode only
                          if (Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") == Environments.Development)
                      .AddMvc(option => option.EnableEndpointRouting = false);
              // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
              public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
                  if (env.IsDevelopment())
                  app.UseReportViewer(settings =>
                      var reportsFolder = Path.Combine(env.ContentRootPath, "Reports");
                      settings.UseFileStore(new DirectoryInfo(reportsFolder));
    8. Run the application. The report opens in the JSViewer.
      Default Run-Time Report