New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial
TreeListDataItem Object
Updated on Oct 24, 2025
Below are listed the properties, methods and collections you should be aware of when working with TreeListDataItem object.
Server-side Properties and Collections
TreeListDataItem provides the following server-side properties:
| Property | Description |
|---|---|
| CanExpand | Returns a boolean value indicating whether the current item can be expanded (has child items). |
| CanExtractValues | Returns a boolean value indicating whether data values can be extracted from the current item. |
| ChildItems | A collection of the TreeListDataItems which are children to the current item. |
| DataItem | Returns the underlying data object to which the TreeListDataItem object is bound.Available only during and after the ItemDataBound event. |
| DataItemIndex | Returns the index of the current item's corresponding record inside the treelist datasource. |
| DetailItem | Returns the TreeListDetailItem corresponding to the current item. |
| DisplayIndex | Returns the index of the current item in the treelist, regardless of the items hierarchy. |
| Edit | Gets or sets a value indicating whether the current item should be edited. |
| EditFormItem | Returns the TreeListEditFormItem corresponding to the current item. |
| Expanded | A boolean value indicating whether the current item is expanded. |
| HierarchyIndex | A complex index composed of two parts - NestedLevel , indicating on which level of the treelist hierarchy is the current item, and LevelIndex which indicates the position of the item in this level. |
| InsertItem | Returns a TreeListEditableItem object which is the inserted (child) item corresponding to the current item. |
| IsChildItemInserted | A boolean value indicating whether a child item is currently being inserted for the item. |
| IsInEditMode | A boolean value indicating whether the item is currently in edit mode. |
| OwnerTreeList | Returns the RadTreeList object to which the current item belongs. |
| ParentItem | Returns TreeListItem which is a parent to the current item in the treelist hierarchy. |
| SavedOldValues | A collection of type IDictionary used while the item is being edited to provide its original values before the current edit operation. |
| Selected | A boolean value indicating whether item is currently selected. |
Server-side Methods
TreeListDataItem provides the following server-side methods:
| Method | Description |
|---|---|
| ExtractValues(IDictionary newValues) | Fills an IDictionary object with the values of the current item (applicable when the item is in edit mode). |
| FireCommandEvent(string eventName, string eventArgs) | Fires a command with the name and arguments provided, which results in the ItemCommand event firing. |
| GetColumnEditor(TreeListEditableColumn editableColumn) | Returns the editor control for the provided column when the current item is in edit mode. |
| GetDataKeyValue(string keyName) | Returns the value of the data field provided as a DataKeyName corresponding to the current item. |
| GetParentDataKeyValue(string keyName) | Returns the value of the data field provided as a ParentDataKeyName corresponding to the current item. |
| InsertChildItem() | Inserts a new child item for the current item. |
| UpdateValues(object objectToUpdate) | Extracts values for each column, using FillValues(IDictionary, GridEditableItem) and updates values in provided object. |