combit List & Label 29 - .NET Help
Inheritance Hierarchy
In This Topic
    combit.Reporting.Web Namespace
    In This Topic

    List & Label can also be used within web applications, albeit with a number of limitations. For ASP.NET-based web applications, List & Label contains components for displaying reports in the web browser (see Use of the Web Report Viewer), which also support complex features such as drill-down, as well as an independent version of the Designer with which reports can be designed on the server with the familiar List & Label Designer (see Use of the Web Designer and Use of the Web Report Designer).


    General Requirements and Notes

    • The server has to be a Windows system, List & Label can only be run on Windows platforms. This restriction of course does not apply to the clients.
    • If no printer driver is installed for the user account under which the web application runs, the property Printerless must be set to true. Then a virtual device will be used for rendering. Note that this may have a minimal impact on the positioning of the output. In addition, it must be ensured that the user account used can load the List & Label DLLs, i.e. that rights have been assigned for the path of the DLLs.
    • Printing within a web application is basically the same as an export e.g. to PDF format, where all dialogs are suppressed. How this is done in general is described in section Export Without User Interaction. After the report is generated that way, the browser of the user can be directed to the created file by the usual mechanisms. Alternatively the file can be sent directly to the user via e-mail if the creation is to be scheduled (see also class MailJob).

    The following image visualizes the principle:


    ClassRenders a bootstrapper that will launch the Web Designer application with the specified List & Label project.
    ClassContains MVC helper methods - see WebReportDesigner(HtmlHelper,WebReportDesignerMVCOptions)
    ClassContains MVC helper methods - see WebReportViewer(HtmlHelper,WebReportViewerMVCOptions)
    ClassInitializes a new instance of the WebReportViewerTheme class that contains the default theme for the Web Report Viewer. The theme can be applied by setting the "theme"-property of the Web Report Viewer component to the serialized JSON or by using the @Html.WebReportViewer helper.
    ClassInitializes a new instance of the WebReportViewerThemeButton class that contains the default viewer button settings.
    ClassInitializes a new instance of the WebReportViewerThemeColors class that contains the default viewer colors.
    ClassInitializes a new instance of the WebReportViewerThemeMessageColors class that contains the default viewer colors for information messages.
    ClassInitializes a new instance of the WebReportViewerThemeSize class that contains the default viewer sizes.
    EnumerationSets the source for referenced Javascript and CSS files (jQuery, jQuery Mobile, ...).

    Internally, combit.ListLabel29.Web.dll uses the ASP.NET MVC and WebAPI frameworks. In order for the required references to be found, you will need to add the relevant NuGet packages to your own project as well. However, we recommend going through the respective NuGet packages, where the necessary dependencies are automatically added accordingly.

    Please note that only .NET Framework versions 4.8 and above are supported. For the .NET 6/.NET 7/.NET 8 support please look at chapter Notes for .NET 6/.NET 7/.NET 8.

    See Also