Do I Need to Use a Data Source Component?
|Product||Progress® Telerik® Reporting|
The Telerik Reporting Data Source Components allow you to connect data items (e.g.
Graph) to different types of data sources such as database or middle-tier business objects, without additional code. Note that they should not be confused with the .NET Data Sources available in the Visual Studio.
Telerik Reporting Data Source Components are intended to specify declaratively how to retrieve data for Data Items but do not contain any data themselves. Their purpose is only to specify the means how to obtain it (e.g. in the case of
SqlDataSource - by executing a SQL query against a database, in the case of
ObjectDataSource - by invoking a method/property of a custom business object, etc.). You can view the Data Source Components as wrappers for your data that can only read it and cannot modify it.
Having the above into account:
Data source components are suitable:
- When data can be retrieved from the server in a declarative manner e.g. a SQL query, or a custom data access layer that gets data records;
- In technology specific scenarios, where data can be modified by the user and you need to display the updated records in a report, our recommendation is to save the updated data on the server and to use a data source component. This approach allows to use reports from any type of project - desktop, web.
Data source components are not required:
- When the data object is already created in code. You can directly set a data item's DataSource to the existing data object;
- When data items are using the same data and you use a Reporting version prior to R3 2019 (18.104.22.1688). With the older versions, each data item will execute its data retrieval method on its own, even if all data items are bound to the same data source component. In such case, you can reorganize the layout in order to benefit from data-binding approaches like Databind to Collection Properties and Use DataObject as a datasource for nested data items (Table, List, Crosstab, Graph).