Edit this page

Declarative Definition

RadTreeList enables you to bind to self-hierarchical data structures anddisplay them. You can define the control completely in mark-up. Following is a description of the keypoints in RadTreeList declarative definition:

  1. You need to specify the id of the data source that the RadTreeList control will be bound to (through the DataSourceID property) and the ParentDataKeyNames and DataKeyNames which define thehierarchical relations in the control.

  2. Then you should choose between:

    • using the feature for automatically generating columns(AutoGenerateColumns = "true", the default value) which will create a column for each field in the specified data source. The auto-generated columns will be displayed in thesame order as the fields in the data source.
    • creating the columns through mark up or dynamically at runtime. In this case they will bedisplayed in the order you declare them.
  3. Once you are ready to display your data, you can customize the additional features of thecontrol, like paging, sorting and item selection.

  4. The last touch to the control would be customizing its appearance - you can setits Skin property to point to one of our built-in Skins or a custom one. Also, you can use the styling properties exposed in order to access and modify the look of only certainparts of the control. These are: PagerStyle, ItemStyle, AlternatingItemStyle, HeaderStyle,SelectedItemStyle.

<telerik:RadTreeList RenderMode="Lightweight" ID="RadTreeList1" runat="server" DataSourceID="SqlDataSource1"
    ParentDataKeyNames="ReportsTo" DataKeyNames="EmployeeID" AutoGenerateColumns="false"
    AllowPaging="true" PageSize="7" AllowMultiItemSelection="true" Skin="Vista">
    <ClientSettings Selecting-AllowItemSelection="true" />
    <Columns>
        <telerik:TreeListBoundColumn DataField="ReportsTo" UniqueName="ReportsTo" HeaderText="Reports To" />
        <telerik:TreeListBoundColumn DataField="EmployeeID" UniqueName="EmployeeID" HeaderText="Employee ID" />
        <telerik:TreeListTemplateColumn UniqueName="Name" HeaderText="Name">
            <HeaderTemplate>
                Full Name
            </HeaderTemplate>
            <ItemTemplate>
                <%# Eval("FirstName")%>&nbsp;<%# Eval("LastName")%>
            </ItemTemplate>
            <HeaderStyle Width="200px" />
            <ItemStyle HorizontalAlign="Center" />
        </telerik:TreeListTemplateColumn>
        <telerik:TreeListBoundColumn DataField="BirthDate" UniqueName="BirthDate" DataFormatString="{0:dd/MM/yy}" 
            HeaderText="Birth Date" />
        <telerik:TreeListCheckBoxColumn UniqueName="CheckBoxColumn" />
    </Columns>
</telerik:RadTreeList>
<asp:SqlDataSource ID="SqlDataSource1" ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
    ProviderName="System.Data.SqlClient" SelectCommand="SELECT EmployeeID, LastName, FirstName, Title, BirthDate, ReportsTo FROM Employees"
    runat="server">
</asp:SqlDataSource>