New to Telerik UI for ASP.NET AJAXStart a free 30-day trial

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.

See Also