C1WebReport works in the same way as other Web controls in the Visual Studio ASP.NET environment: the control on the server side renders itself into an HTML stream that gets sent to the client. C1WebReport can also render PDF streams to the client.
To use the C1WebReport control, simply drag it onto an ASPX page, set the ReportSource property to select the report you want to show, and optionally customize the appearance of the control by setting a few properties (for example, Paged, DrillDown, NavigationBar).
When you run the application, C1WebReport will load the report definition you selected and render it directly into HTML which is displayed on the client's machine. Also, C1WebReport will automatically cache the reports it renders, so subsequent requests for the same report will be served very quickly. The information stored in the cache is compressed, so the load on the server is dramatically reduced.
Tip: C1WebReport loads the report definition from the ReportSource every time it loads; therefore, you can save some time on the server if you store each report definition in a separate XML file. If the XML file contains multiple reports, the control will need to read them all before it can extract the one it is looking for.
Because C1WebReport hosts the C1Report component, you can use exactly the same report definitions that you use in Windows applications. You can also use the rich C1Report object model to customize reports on-the-fly, providing ad-hoc reporting capability to your pages. If you already know how to use the C1Report control, you should be able to easily learn how to use C1WebReport. If you are not familiar the C1Report control, you can still use C1WebReport, but you will eventually need to learn how to use C1Report in order to use the advanced features it provides (for example, report customization and generation and RTF export).
The C1WebReport control is contained in the C1.Web.C1WebReport.2.dll file. It depends on the following assemblies:
• C1.C1Report.2.dll (which contains the C1Report component)
• C1.C1PrintDocument.Classic.2.dll and C1.Win.C1PrintPreview.Classic.2.dll (which provides PDF rendering)
For details on creating reports using the C1ReportDesigner or creating and customizing report definitions using the C1Report object mode, refer to the C1Report documentation.
|