The Web Report Viewer supports all common browser types. Thus, it can be used on clients with different operating systems. It allows interactive input through drilldown and report parameters.

Requirements

• Assemblies: First of all, references to the two assemblies combit.ListLabel28.dll and combit.ListLabel28.Web.dll must be added in the project. This can also be achieved by adding the corresponding NuGet-Packages, for example.
• The following external NuGet packages are also required:
  • Newtonsoft.Json at least in version 13.0.1.
  • System.CodeDom at least in version 5.0.0.
  • Microsoft.AspNetCore.Mvc.NewtonsoftJson with their specific .NET version.
    Additionally locate the line builder.Services.AddControllersWithViews(); and replace it with builder.Services.AddControllersWithViews().AddNewtonsoftJson();.

Integration - Create new Controller

Then create a new controller as usual - in the following the name MyWebReportViewerController is used as an example. Derive the controller from the WebReportViewerController class:

...
public class MyWebReportViewerController : WebReportViewerController
...

...
Public Class MyWebReportViewerController
        Inherits WebReportViewerController
...

Integration - Override important Methods

Then implement the two abstract methods OnProvideListLabel and OnProvideRepository. Pass your List & Label instance with matching data source and temporary export path repectively the Repository to be used in the respective arguments provided.

...
public override void OnProvideListLabel(ProvideListLabelContext provideListLabelContext)
{
    // Create List & Label object
    ListLabel ll = new ListLabel();
    ll.LicensingInfo = "<ToDo: insert your license here>"

    // Define datasource
    var dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId);
    ll.DataSource = dataSource;

    // The Web Report Viewer requires a directory for temporary files. Some minutes after a Web Report Viewer is closed, these files will be deleted automatically
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles");

    // Return configured List & Label object
    provideListLabelContext.NewInstance = ll;
}

public override void OnProvideRepository(ProvideRepositoryContext provideFileRepositoryContext)
{
    provideFileRepositoryContext.FileRepository = GetRepository();
} 
...

...
Public Overrides Sub OnProvideListLabel(ByVal provideListLabelContext As ProvideListLabelContext)

    ' Create List & Label object
    Dim ll As ListLabel = New ListLabel()
    ll.LicensingInfo = "<ToDo: insert your license here>"

    ' Define datasource
    Dim dataSource = GetDataProvider(provideListLabelContext.RepositoryItemId)
    ll.DataSource = dataSource

    ' The Web Report Viewer requires a directory for temporary files. Some minutes after a Web Report Viewer is closed, these files will be deleted automatically
    provideListLabelContext.ExportPath = Server.MapPath("~/App_Data/TempFiles")

    ' Return configured List & Label object
    provideListLabelContext.NewInstance = ll

End Sub

Public Overrides Sub OnProvideRepository(ByVal provideFileRepositoryContext As ProvideRepositoryContext)

    provideFileRepositoryContext.FileRepository = GetRepository()

End Sub
...

Integration - .NET Switch

The further procedure differs for .NET Core 3.1/.NET 5/.NET 6 and .NET 4.x.

.NET Core 3.1/.NET 5/.NET 6:

If you see a startup.cs file (otherwise see below), add the following lines to the end of the Configure method:

...
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // do some other stuff here
    // ...

    app.UseWebReportViewer();
}
...

If there is no startup.cs you should have a program.cs in .NET 6. In this case, add app.UseWebReportViewer(); right after any other app.Use... call and add builder.Services.AddWebReportViewer(); right after any other builder.Services... call. 

.NET 4.x:

In the global.asax.cs/global.asax.vb file, add the following line before the RouteConfig.RegisterRoutes() call:

...
WebReportViewerConfig.RegisterRoutes(RouteTable.Routes);
...

...
WebReportViewerConfig.RegisterRoutes(RouteTable.Routes)
...

Using Web Report Viewer

The configuration is now complete. Now the Web Report Viewer can be inserted and used in the desired view as follows:

...
@using combit.Reporting.Web
@{
    Layout = null;
    string repositoryId = Request.QueryString["reportRepositoryID"];
    if (!String.IsNullOrEmpty(repositoryId))
    {
        repositoryId = repositoryId.Replace("repository://{", "").Replace("}", "");
    }
}
<!DOCTYPE html>
@Html.WebReportViewer("Web Report Viewer", repositoryId)
...

Further

The List & Label installation contains corresponding ASP.NET examples that show the use of the Web Report Viewer in detail both under .NET Core and under .NET 4.x.