combit List & Label 25 - .NET Online Web Help
combit.ListLabel25.Web Namespace
Inheritance Hierarchy

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 (Html5ViewerControl), 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 (Web Designer).


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).

A printer driver has to be installed on the server as well so the print can be successfully executed. List & Label works closely together with the Windows-GDI and therefore requires a printer device context for all operations. The Microsoft XPS printer driver (automatically installed on all systems from .NET Framework 3.5 and higher) is also suitable as a reference printer.

As the process/service is executed in the context of the IIS, it is important that the used ApplicationPool is configured accordingly to have access to the installed printer driver. From IIS versions 7.0/7.5 on (from Windows 7/Server 2008 R2 on), however, the standard identity is the 'ApplicationPoolIdentity'. This is a so called virtual account, that might not have access to the system resources like the printer driver. Therefore, it is mandatory that the defined identity must be reconfigured to e.g. 'NetworkService'.

Generally the project files are created within a client application and then published together with the web application. The following image visualizes the principle:


ClassRenders a bootstrapper that will launch the Web Designer application with the specified List & Label project.
ClassBasic configuration for HTML5Viewer.
ClassRenders an HTML5-based component that displays reports in the browser, supporting all major browsers, operating systems and mobile devices. For the ASP.NET MVC version of this control, see Html5ViewerMVCHelper.Html5Viewer.
ClassContains MVC helper methods.
ClassProperties for an instance of the Html5Viewer.
ClassUsed by the Html5Viewer control when it requires a new ListLabel instance.
ClassUsed by the Html5Viewer control when it requests a list of links that should be displayed in the export menu.
ClassRepresents a link that is rendered in the export menu of the Html5Preview control.
EnumerationSets the source for referenced Javascript and CSS files (jQuery, jQuery Mobile, ...).

Internally, combit.ListLabel25.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.
In the NuGet Package Manager, search for the packages "Microsoft.AspNet.Mvc" (Version 5.2.4 or later) and "Microsoft.AspNet.WebApi" (Version 4.0.30506 or later) and install them. Alternatively, run the following commands from Visual Studio’s "Package Manager Console" window:
Install-Package Microsoft.AspNet.Mvc
Install-Package Microsoft.AspNet.WebApi

Ensure to use the NuGet-Package "Newtonsoft.Json" minimum in version 12.0.2. The latest version can be installed from Visual Studio’s "Package Manager Console" window with the following command:
Install-Package Newtonsoft.Json

Please note that only .NET Framework versions 4.5 and above are supported. For the .NET Core support please look at chapter Notes for .NET Core.

See Also


combit.ListLabel25.Web Assembly