jqGrid supports tree-grid mode, where you can display rows of data of the same structure (column definition)
as hierarchial tree structure. In your model, just set the TreeGridSettings.Enabled property to true
and the grid will be assuming tree-mode response from the server (see the Model code tab for details).
This means that in addition to the row data, you need to return data that will help jqGrid determine the hierarchy of the rows.

When selecting rows, you need to specify some or all of the following reserved fields

  • tree_level - the level of the row in the tree hierarchy. 0 is for root row.

  • tree_leaf - if the row is leaf (no child rows). This will make it non-expandable and will have an alternative icon.

  • tree_expanded - if the row is expanded by default or not.

  • tree_parent - the primary key (ID) of the parent row (only applicable for child rows)

  • tree_loaded - true/false - if the tree nodes are already loaded. Can be used to show several levels expanded by default.


You can also control the different images per grid rows - in expanded, collapsed and leaf states. This can be achieved with the following properties available from the TreeGridSettings collection - ExpandedIcon, CollapsedIcon, LeafIcon
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="default.aspx.cs" Inherits="JQSuiteASPNETExample.examples.grid.treegrid.rowsondemand._default" %>
<%@ Register Assembly="Trirand.Web" TagPrefix="trirand" Namespace="Trirand.Web.UI.WebControls" %>

<!DOCTYPE html>
<html lang="en-us">
<head id="Head1" runat="server">
    <meta charset="utf-8">
    <title>jqGrid for ASP.NET WebForms - TreeGrid - load rows on demand</title>
    <!-- The jQuery UI theme that will be used by the grid -->
    <link rel="stylesheet" type="text/css" media="screen" href="http://ajax.aspnetcdn.com/ajax/jquery.ui/1.11.4/themes/redmond/jquery-ui.css" />
    <!-- The jQuery UI theme extension jqGrid needs -->
    <link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />
    <!-- jQuery runtime minified -->
    <script src="http://ajax.microsoft.com/ajax/jquery/jquery-2.2.0.min.js" type="text/javascript"></script>    
    <!-- The localization file we need, English in this case -->
    <script src="/js/trirand/i18n/grid.locale-en.js" type="text/javascript"></script>
    <!-- The jqGrid client-side javascript -->
    <script src="/js/trirand/jquery.jqGrid.min.js" type="text/javascript"></script>    
    <!-- This jQuery UI library is needed only for the code tabs, not needed by the grid per se -->
        
    <style type="text/css">    
        body, html { font-size: 80%; }
    </style>
</head>


<body>
    <form id="form1" runat="server">
        
    <trirand:JQGrid runat="server" ID="RowsOnDemandGrid" Width="600px" Height="350px">
        <Columns>
            <trirand:JQGridColumn DataField="ID" PrimaryKey="True" Visible="false" />
            <trirand:JQGridColumn DataField="Name" Width="420" />
            <trirand:JQGridColumn DataField="Quantity" />
            <trirand:JQGridColumn DataField="Price"  />
            <trirand:JQGridColumn DataField="Color" />
        </Columns>
        <TreeGridSettings Enabled="true" />        
    </trirand:JQGrid>
    
    <br /><br />
    
    <trirand:codetabs runat="server" id="tabs"></trirand:codetabs> 
    
    </form>
</body>
</html>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Trirand.Web.UI.WebControls;
using System.Data;
using System.Data.SqlClient;
using System.Configuration;

namespace JQSuiteASPNETExample.examples.grid.treegrid.rowsondemand
{
    public partial class _default : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            if (RowsOnDemandGrid.AjaxCallBackMode == AjaxCallBackMode.RequestData)
            {
                DataTable data;
                JQGridTreeExpandData expandData = RowsOnDemandGrid.GetTreeExpandData();

                if (expandData.ParentID == null)
                {
                    data = GetRootData();
                }
                else
                {
                    data = GetChildData(expandData.ParentLevel, expandData.ParentID);
                }

                RowsOnDemandGrid.DataSource = data;
                RowsOnDemandGrid.DataBind();
            }
        }

        protected DataTable GetRootData()
        {
            // Create a new Sql Connection and set connection string accordingly
            SqlConnection sqlConnection = new SqlConnection();
            sqlConnection.ConnectionString = ConfigurationManager.ConnectionStrings["SQL2008_449777_fhsConnectionString"].ConnectionString;
            sqlConnection.Open();

            // ********************************************************************************************
            // when selecting rows, you need to specify some or all of the following reserved fields
            // tree_level - the level of the row in the tree hierarchy. 0 is for root row.
            // tree_leaf - if the row is leaf (no child rows). This will make it non-expandable and will have an alternative icon
            // tree_expanded - if the row is expanded by default or not
            // tree_parent - the primary key (ID) of the parent row (only applicable for child rows)
            // tree_loaded - true/false - if the tree nodes are already loaded. Can be used to show several levels expanded by default.
            // ********************************************************************************************
            string sqlStatement = @"SELECT
                                        ID, 
                                        Name, 
                                        Price, 
                                        Color, 
                                        Quantity, 
                                        0 AS 'tree_level', 
                                        0 AS 'tree_expanded',
                                        CASE WHEN
                                            (SELECT COUNT(*) AS Expr1
                                                FROM            
                                                    RetailData
                                                WHERE        
                                                    (ParentID = A.ID)
                                            ) = 0 THEN 1 ELSE 0 END AS 'tree_leaf'                                        
                                     FROM            
                                        RetailData AS A
                                     WHERE
                                        A.ParentID IS null";

            // Create a SqlDataAdapter to get the results as DataTable
            SqlDataAdapter sqlDataAdapter = new SqlDataAdapter(sqlStatement, sqlConnection);

            // Create a new DataTable
            DataTable dtResult = new DataTable();

            // Fill the DataTable with the result of the SQL statement
            sqlDataAdapter.Fill(dtResult);

            return dtResult;
        }

        protected DataTable GetChildData(int level, string parentID)
        {
            int childLevel = level + 1;
            // Create a new Sql Connection and set connection string accordingly
            SqlConnection sqlConnection = new SqlConnection();
            sqlConnection.ConnectionString = ConfigurationManager.ConnectionStrings["SQL2008_449777_fhsConnectionString"].ConnectionString;
            sqlConnection.Open();

            // ********************************************************************************************
            // when selecting rows, you need to specify some or all of the following reserved fields
            // tree_level - the level of the row in the tree hierarchy. 0 is for root row.
            // tree_leaf - if the row is leaf (no child rows). This will make it non-expandable and will have an alternative icon
            // tree_expanded - if the row is expanded by default or not
            // tree_parent - the primary key (ID) of the parent row (only applicable for child rows)
            // tree_loaded - true/false - if the tree nodes are already loaded. Can be used to show several levels expanded by default.
            // ********************************************************************************************
            string sqlStatement = @"SELECT
                                        ID, 
                                        Name, 
                                        Price, 
                                        Color, 
                                        Quantity, 
                                        ParentID,
                                        {0} AS 'tree_level', 
                                        {1} AS 'tree_parent',
                                        0 AS 'tree_expanded',
                                        CASE WHEN
                                            (SELECT COUNT(*) AS Expr1
                                                FROM            
                                                    RetailData
                                                WHERE        
                                                    (ParentID = A.ID)
                                            ) = 0 THEN 1 ELSE 0 END AS 'tree_leaf'                                        
                                     FROM            
                                        RetailData AS A
                                     WHERE
                                        A.ParentID = {1}";

            sqlStatement = String.Format(sqlStatement, childLevel.ToString(), parentID);

            // Create a SqlDataAdapter to get the results as DataTable
            SqlDataAdapter sqlDataAdapter = new SqlDataAdapter(sqlStatement, sqlConnection);

            // Create a new DataTable
            DataTable dtResult = new DataTable();

            // Fill the DataTable with the result of the SQL statement
            sqlDataAdapter.Fill(dtResult);

            return dtResult;
        }
    }
}
Switch theme:


Theming is based on the very popular jQuery ThemeRoller standard. This is the same theming mechanism used by jQuery UI and is now a de-facto standard for jQuery based components. The benefits of using ThemeRoller are huge. We can offer a big set of ready to use themes created by professional designers, including Windows-like themes (Redmond), Apple-like theme (Cupertino), etc. In addition to that any jQuery UI controls on the same page will pick the same theme.

Last, but not least, you can always roll your own ThemeRoller theme, using the superb Theme Editor

To use a theme, simply reference 2 Css files in your Html <head> section - the ThemeRoller theme you wish to use, and the jqGrid own ThemeRoller Css file. For example (Redmond theme):

<link rel="stylesheet" type="text/css" media="screen" href="/themes/redmond/jquery-ui-1.8.2.custom.css" />
<link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />