jqGrid ASP.NET example with SqlDataSource

Info
ASPX
C#
Themes

You can show any level of nested subgrids (master detail) inside a parent grid. Just set the HierarchySettings.HierarchyMode property of the parent grid to "Parent" for the parent grid and to "Child" for the child ones. If you have a grid that is a parent and a child at the same time (e.g. the second level grid in a 3 level hierarchy), set its HierarchySettings.HierarchyMode property to "ParentAndChild".

Then, hook the client-side ClientSideEvents.OnClientSubGridRowExpanded event of the grid and call a special javascript function, which is autogenerated by child grids and is called showSubGrid_{GridID}, where {GridID} is the ID of the child grid, e.g. showSubGrid_JQGrid2

It's as simple as that, this will in essense trigger the sever-side OnDataRequesting of the grid and you can get the ID of the parent row and bind the child grid accordingly.

Complete hierarchy is achieved in this example with just 2 lines of code - 1 javascript and 1 C# (check the ASPX and C# tabs for details).

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="default.aspx.cs" Inherits="GridTest.examples.hierarchy.subgrid_3_level._default" %>

<%@ Register Assembly="Trirand.Web" TagPrefix="trirand" Namespace="Trirand.Web.UI.WebControls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>jqGrid ASP.NET example with SqlDataSource</title>
    <!-- The jQuery UI theme that will be used by the grid -->
    <link rel="stylesheet" type="text/css" media="screen" href="/themes/redmond/jquery-ui-1.8.2.custom.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="/js/jquery-1.4.2.min.js" type="text/javascript"></script>
    <!-- The localization file we need, English in this case -->
    <script src="/js/i18n/grid.locale-en.js" type="text/javascript"></script>
    <!-- The jqGrid client-side javascript -->
    <script src="/js/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 -->
    <script src="/js/jquery-ui-1.8.2.custom.min.js" type="text/javascript"></script>

    <style type="text/css">
        body, html
        {
            font-size: 80%;
        }
    </style>
</head>
<body>
    <form id="form1" runat="server">
    <asp:ScriptManager runat="server" ID="ScriptManager1"></asp:ScriptManager>
    <asp:SqlDataSource runat="server" ID="SqlDataSource1" ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>"
        SelectCommand="SELECT [CustomerID], [CompanyName], [ContactName], [Phone], [City] FROM [Customers]">
    </asp:SqlDataSource>
    <asp:SqlDataSource runat="server" ID="SqlDataSource2" ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>"
        SelectCommand="SELECT [OrderID], [CustomerID], [RequiredDate], [ShipName], [ShipCity], [Freight] FROM [Orders] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
            <asp:Parameter DefaultValue="" Name="CustomerID" Type="String" />
        </SelectParameters>
    </asp:SqlDataSource>
    <asp:SqlDataSource runat="server" ID="SqlDataSource3" 
        ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>" 
        SelectCommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity], [Discount] FROM [Order Details] WHERE ([OrderID] = @OrderID)">
        <SelectParameters>
            <asp:Parameter Name="OrderID" Type="Int32" />
        </SelectParameters>
    </asp:SqlDataSource>


    <span style="font-size: 135%; font-family: Verdana; font-weight: bold">Click on a row to see all orders for this customer</span>
    
    <trirand:JQGrid runat="server" ID="JQGrid1" DataSourceID="SqlDataSource1" Width="100%" Height="100%">
        <Columns>
            <trirand:JQGridColumn DataField="CustomerID" HeaderText="ID" PrimaryKey="True" Width="50" />
            <trirand:JQGridColumn DataField="CompanyName" />
            <trirand:JQGridColumn DataField="ContactName" />
            <trirand:JQGridColumn DataField="Phone" />
            <trirand:JQGridColumn DataField="City" />
        </Columns>
        <HierarchySettings HierarchyMode="Parent" />
        <ClientSideEvents SubGridRowExpanded="showSubGrid2" />
        <ToolBarSettings ShowRefreshButton="true" ShowSearchButton="true" />
    </trirand:JQGrid>
    <br />
    <br />       
        
    <trirand:JQGrid runat="server" ID="JQGrid2" 
        DataSourceID="SqlDataSource2"
        Width="100%" 
        Height="100%"       
        OnDataRequesting="JQGrid2_DataRequesting">        
        <Columns>
            <trirand:JQGridColumn DataField="OrderID" HeaderText="Order ID" PrimaryKey="True" Width="50" />
            <trirand:JQGridColumn Editable="true" DataField="RequiredDate" DataFormatString="{0:d}" Width="100" />
            <trirand:JQGridColumn Editable="true" DataField="ShipName" Width="200" />
            <trirand:JQGridColumn Editable="true" DataField="ShipCity" Width="100" />
            <trirand:JQGridColumn DataField="Freight" Width="100" />
        </Columns>
        <HierarchySettings HierarchyMode="ParentAndChild" />
        <ClientSideEvents SubGridRowExpanded="showSubGrid3" />
        <ToolBarSettings ShowRefreshButton="true" ShowSearchButton="true" ShowAddButton="true" ShowEditButton="true" />
        <EditDialogSettings CloseAfterEditing="true" />
        <AddDialogSettings CloseAfterAdding="true" />
    </trirand:JQGrid>
    
    <trirand:JQGrid runat="server" ID="JQGrid3" DataSourceID="SqlDataSource3" 
        Width="350px" Height="100%"
        OnDataRequesting="JQGrid3_DataRequesting">        
        <Columns>
            <trirand:JQGridColumn DataField="OrderID" PrimaryKey="True" Width="50" />
            <trirand:JQGridColumn DataField="ProductID" />
            <trirand:JQGridColumn DataField="UnitPrice" Width="200" />            
        </Columns>
        <ToolBarSettings ShowRefreshButton="true" ShowSearchButton="true" />
        <HierarchySettings HierarchyMode="Child" />
    </trirand:JQGrid>
    
    <script type="text/javascript">       

        // the "showSubGrid_JQGrid2" function is autogenerated by the second child grid. Calling it will place the child grid below
        // the parent expanded row and will call the OnDataRequesting event of the child grid, with ID equal to the ID of the parent
        function showSubGrid2(subgrid_id, row_id) {
            showSubGrid_JQGrid2(subgrid_id, row_id);            
        }

        function showSubGrid3(subgrid_id, row_id) {
            showSubGrid_JQGrid3(subgrid_id, row_id);            
        }

    
    </script>

    <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;

namespace GridTest.examples.hierarchy.subgrid_3_level
{
    public partial class _default : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
        }

        public void JQGrid2_DataRequesting(object sender, JQGridDataRequestEventArgs e)
        {
            SqlDataSource2.SelectParameters["CustomerID"].DefaultValue = e.ParentRowKey;
        }

        public void JQGrid3_DataRequesting(object sender, JQGridDataRequestEventArgs e)
        {
            SqlDataSource3.SelectParameters["OrderID"].DefaultValue = e.ParentRowKey;
        }
        
    }
}

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.1.custom.css" />
<link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />