Server-side Data Binding Overview
RadTimeline fully supports binding to various data sources:
Data sources can support both hierarchical and non-hierarchical structures. RadTimeline, however, only works with a flat structure - items cannot contain children.
Databinding Properties and Methods
The following properties and methods are used when binding RadTimeline to a data source:
-
DataSource property - set to an instance of your data source. This is mandatory when binding RadTimeline at runtime.
-
DataSourceID property - set to the ID of your data source. This is mandatory when binding RadTimeline declaratively.
-
DataMember property - if the data source is a DataSet and DataMember is set, then RadTimeline is bound to the DataTable with the respective name in the DataSet. If DataMember is not set, RadTimeline is bound to the first DataTable in the DataSet.
-
DataDateField property - field name from the data source to bind to the Date property of the
TimelineItem
. -
DataTitleField property - field name from the data source to bind to the Title property of the
TimelineItem
. -
DataSubtitleField property - field name from the data source to bind to the Subtitle property of the
TimelineItem
. -
DataDescriptionField property - field name from the data source to bind to the Description property of the
TimelineItem
. -
DataImagesField property - field name from the data source to bind to the Images collection.
-
DataActionsField property - field name from the data source to bind to the Actions collection.
-
DataKeyNames property - lists the additional fields of the DataSource that will be mapped to each event item.
-
DataBind method - must be called after the aforementioned properties are set, when binding at runtime. This method is mandatory for binding at runtime.
If you need to map additional fields from the Data Source to properties of RadTimeline item, the ItemDataBound event should be used. See Binding To ASP DataSource Components, for an example.