Skip to main content
A newer version of this page is available. .

Bound Mode

  • 3 minutes to read

Online Video

Learn how to create a Tree List control, bind it to data, and customize the control’s view and behavior options.


The Tree List control can be bound to any traditional data source: a BindingSource, BindingList<T>, List<T>, DataTable, DataView and DataSet objects, objects that implement specific interfaces (e.g., IList, ITypedList and IBindingList), SQL data, XML data, Excel data sources, etc.

Use the following properties to perform binding.

More information is provided below.

TreeList Control Binding Specifics

Like other data-aware controls, the Tree List control provides the traditional TreeList.DataSource and TreeList.DataMember properties for binding. Use the latter property if the TreeList.DataSource is a DataSet object (DataSets can contain multiple tables).

Due to the hierarchical structure of Tree List nodes, the bound data source must contain two fields to identify the relationship between records. Assign these two field names to the following properties:

Besides these two properties, you also need to specify the TreeList.RootValue property, which allows the Tree List control to determine root nodes. Data source records that have the RootValue in the ParentFieldName field will be regarded as root nodes. To learn more about the node hierarchy setting-up, see the following topic:


  • Although Tree List allows you to display records from an underlying data source as a plain list (the TreeList.KeyFieldName and TreeList.ParentFieldName properties must be empty), we recommend using the Data Grid control for this task.
  • Dynamic data loading (virtual mode) is not supported in bound mode.
  • To sort data, do not use the methods provided by the bound data source. Instead, sort data using methods provided by the Tree List control. See Sorting to learn more.



The topics in the following section describe common data-binding concepts and scenarios that are applied to the Tree List, Data Grid, and other data-aware controls.

General Data Binding Concepts

See Also