Deciding on Report Generation Method
In This Topic
Because twways of generating reports are available (using the C1Report component vs. importing the report inta C1PrintDocument), you may ask, "Which method is preferable?" Our recommendations are as follows:
- If any of the limitations of import (see Generating Reports (C1Report vs. C1PrintDocument) for a list of limitations) are critical tyour application, use the C1Report component.
- If you are a user of a previous version of C1Report and are not familiar with the C1PrintDocument object model, you may still continue tuse the C1Report component provided by C1Preview.
- If, on the other hand, you have some experience with C1PrintDocument, or are starting a new project, using import is the preferred approach, due tthe following considerations:
- C1PrintDocument integration: when a report definition has been imported inta C1PrintDocument, the resulting document can be manipulated as any other C1PrintDocument. For example, user code can add content tthe document body, modify document properties, and son. Such changes will persist even when the document is refreshed.
- Some problems existing in C1Report are solved by import; specifically, in C1Report side-by-side objects cannot be correctly split between pages, and borders are not rendered correctly on objects split between pages. Neither of these problems exists when a report is imported intC1PrintDocument.
- Import is slightly more efficient both memory- and speed-wise.
- Future enhancements: it is likely that some future enhancements will affect only import.