Click here to Skip to main content
Click here to Skip to main content

Editable Nested DataGrid

, 11 Mar 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
How to Create a Nested DataGrid in ASP.NET Using C#
Screenshot - EditNestedGridView.JPG

Introduction

This article explains how to make an ASP.NET Editable Nested GridView. Here I am going to explain how to provide all the features of Edit/Add/Delete/Update/Page/Sort of a GridView, and not only one GridView, but I am going to explain how to extend these features to even nested grids (GridView inside GridView). I have provided the fully functional source code, which is self-explanatory.

Background

My previous article explains about the features of Nested Editable DataGrid. This article provides all those features in GridView (Visual Studio 2005, .NET 2.0). With the combination of GridView and DataSource controls, it's very easy to create an Editable GridView.

Using the Code

This is a web application with a virtual directory named EditNestedGridView. You may create the same virtual directory to run this application with Visual Studio .NET 2005 or create any other virtual directory and map the path to this directory to access it from the browser. As I have used Access 2003 as my database, you need to have Microsoft Access installed on your machine. I have used NorthWind database with some modifications. I have included this also in the code bundle under the App_Data folder. I have used C# for codebehind files. In Visual Studio 2005, File --> Open --> Web Site and navigate to the folder EditNestedGridView.

Step-by-Step Procedure

The code attached is self-explanatory, but will try to explain as much as possible.

1. Since here I am going to use the DataSource control, let's first create a Access DataSource control as mentioned below.

<asp:AccessDataSource ID="AccessDataSource1" runat="server" 
    DataFile="App_Data/Northwind.mdb" 
    SelectCommand="SELECT [Customers].[CustomerID], 
    [Customers].[CompanyName],[Customers].[ContactName],
    [Customers].[ContactTitle],[Customers].[Address] FROM [Customers] 
    ORDER BY [Customers].[CustomerID]"></asp:AccessDataSource>

The main advantage of the DataSource control is that it simplifies the amount of custom code that needs to be written to retrieve and bind data, and even to sort, page through or edit data.

2. Now let's create a simple GridView control and attach the previously created DataSource control as below.

<asp:GridView ID="GridView1" AllowPaging="True" BackColor="#f1f1f1" 
            AutoGenerateColumns=false DataSourceID="AccessDataSource1" 
            DataKeyNames="CustomerID"
            style="Z-INDEX: 101; LEFT: 8px; POSITION: absolute; TOP: 32px" 
            ShowFooter=true Font-Size=Small
            Font-Names="Verdana" runat="server" GridLines=None BorderStyle=Outset>

GridView is very similar to DataGrid and it has all those column features of DataGrid like TemplateColumn, BoundColumn to populate data as columns. EditItemTemplate and FooterTemplate can be used for editing and adding purpose. Following code shows the columns of parent Grid.

<asp:TemplateField HeaderText="Customer ID" SortExpression="CustomerID">
    <ItemTemplate>
        <asp:Label ID="lblCustomerID" Text='<%# Eval("CustomerID") %>' 
            runat="server"></asp:Label>
    </ItemTemplate>
    <EditItemTemplate>
        <asp:Label ID="lblCustomerID" Text='<%# Eval("CustomerID") %>' 
            runat="server"></asp:Label>
    </EditItemTemplate>
    <FooterTemplate>
        <asp:TextBox ID="txtCustomerID" Text='' runat="server"></asp:TextBox>
    </FooterTemplate>
</asp:TemplateField>
<asp:TemplateField HeaderText="Company Name" SortExpression="CompanyName">
    <ItemTemplate><%# Eval("CompanyName") %></ItemTemplate>
    <EditItemTemplate>
        <asp:TextBox ID="txtCompanyName" Text='<%# Eval("CompanyName") %>' 
            runat="server"></asp:TextBox>
    </EditItemTemplate>
    <FooterTemplate>
        <asp:TextBox ID="txtCompanyName" Text='' runat="server"></asp:TextBox>
    </FooterTemplate>
</asp:TemplateField>
..........................
..........................

<asp:CommandField HeaderText="Edit" ShowEditButton="True" />
<asp:TemplateField HeaderText="Delete">
    <ItemTemplate>
        <asp:LinkButton ID="linkDeleteCust" CommandName="Delete" 
            runat="server">Delete</asp:LinkButton>
    </ItemTemplate>
    <FooterTemplate>
        <asp:LinkButton ID="linkAddCust" CommandName="AddCustomer" 
            runat="server">Add</asp:LinkButton>
    </FooterTemplate>
</asp:TemplateField>

Now that we have all the columns in place, we need the event handlers to take care of Add/Edit/Delete actions. Handling these events is very straightforward compared to DataGrid. The DataSource control takes care of the Paging and Sorting actions. Here is the final parent GridView control with all these events.

<asp:GridView ID="GridView1" AllowPaging="True" BackColor="#f1f1f1" 
            AutoGenerateColumns=false DataSourceID="AccessDataSource1" 
            DataKeyNames="CustomerID"
            style="Z-INDEX: 101; LEFT: 8px; POSITION: absolute; TOP: 32px" 
            ShowFooter=true Font-Size=Small
            Font-Names="Verdana" runat="server" GridLines=None 
            OnRowDataBound="GridView1_RowDataBound" 
            OnRowCommand = "GridView1_RowCommand" 
            OnRowUpdating = "GridView1_RowUpdating" BorderStyle=Outset
            OnRowDeleting = "GridView1_RowDeleting" 
            OnRowDeleted = "GridView1_RowDeleted"
            OnRowUpdated = "GridView1_RowUpdated" AllowSorting=true>

With all the above options, GridView looks like below.

Screenshot - EditNestedGridView1.jpg

3. Until now, we have created parent a GridView. Now we are going to extend these features in a child GridView as well.

Before adding another GridView, we must understand how GridView emits its content as HTML tags. For an Internet Explorer browser, GridView is like a regular Table with TR and TD tags. So, if we can manipulate the parent GridView to forcibly close a row and emit Child GridView as another ROW, we are done with it.

What is displayed is some HTML table cell and row tags that effectively intercept the current output that will be generated by the GridView with our own special implementation. Namely, we are telling the table (when it's drawn) to close the current cell, the current row and now add a new row with one blank column (for spacing) and another column (spanning all columns) that we'll use to display a second GridView. Here is the piece of code which explains this:

<asp:TemplateField>
    <ItemTemplate>
        <tr>
        <td colspan="100%">
        <div id="div<%# Eval("CustomerID") %>" 
            style="display:none;position:relative;left:15px;OVERFLOW: auto;WIDTH:97%" >

Here I have created a division id="div Eval("CustomerID") with an ID of Customer (parent row) which holds Child GridView so that we can dynamically hide and expand it by using DIV ID. Also, we need a column in the main GridView which holds the image to expand and collapse the child GridView as below.

<asp:TemplateField>
    <ItemTemplate>
        <a href="javascript:expandcollapse('div<%# Eval("CustomerID") %>', 'one');">

Here the JavaScript function expandcollapse will take care of expand and collapse action.

4. In order to bind the Child GridView, we can't use static DataSource control as we have used for parent GridView. We will have to dynamically prepare the query based on the Customer ID of the corresponding parent row and that we can do it in RowDataBound event of the parent Grid as below.

protected void GridView1_RowDataBound(object sender, GridViewRowEventArgs e)
    {
        GridViewRow row = e.Row;
        string strSort = string.Empty;

        // Make sure we aren't in header/footer rows
        if (row.DataItem == null)
        {
            return;
        }

        //Find Child GridView control
        GridView gv = new GridView();
        gv = (GridView)row.FindControl("GridView2");

        //Prepare the query for Child GridView by passing 
        //the Customer ID of the parent row
        gv.DataSource = 
            ChildDataSource(((DataRowView)e.Row.DataItem)["CustomerID"].ToString(), 
            strSort);
        gv.DataBind();
    }

Here the ChildDataSource function forms the query using the passed Customer ID and returns AccessDataSource.

5. Now we have data in Child Grid as well with dynamic expand and collapse. Let's add effects one by one as we did for parent grid. However, before going further, there is a little tricky part involved. In the case of the parent grid, there is only a unique ID (GridView1) and in the case of the child there will be several unique IDs that get generated at run time. If we can identify the one which we need, that will solve this problem.

Paging and Sorting were taken care of by DataSource control in the case of the parent grid. For the child grid, we have to take care of it manually using the corresponding events PageIndexChanging and Sorting. A sample code of paging event looks like below.

protected void GridView2_PageIndexChanging(object sender, GridViewPageEventArgs e)
    {
        GridView gvTemp = (GridView)sender;
        gvUniqueID = gvTemp.UniqueID;
        gvNewPageIndex = e.NewPageIndex;
        GridView1.DataBind();
    }

Here we have identified the run time Unique ID of the child grid which needs paging along with the new page number. We are going to use these variable values in the RowDataBound event of the parent grid as below.

protected void GridView1_RowDataBound(object sender, GridViewRowEventArgs e)
    {
        ........................
        //Find Child GridView control
        GridView gv = new GridView();
        gv = (GridView)row.FindControl("GridView2");
        //Check if any additional conditions (Paging, Sorting, Editing, etc) 
        //to be applied on child GridView
        if (gv.UniqueID == gvUniqueID)
        {
            gv.PageIndex = gvNewPageIndex;
            gv.EditIndex = gvEditIndex;
            //Check if Sorting used
            if (gvSortExpr != string.Empty)
            {
                GetSortDirection();
                strSort = " ORDER BY " + string.Format("{0} {1}", gvSortExpr, gvSortDir);
            }
            //Expand the Child grid
            ClientScript.RegisterStartupScript(GetType(), "Expand", 
                "<script language="javascript"></script>");
        }
        ..........................
    }

The remaining actions (Sorting/Edit/Update/Delete) can also be handled similarly to paging. Refer to the source code attached above.

Conclusion

GridView has more features compared to DataGrid, which will make it easier to code and also we can include HTML tags in between for more flexibility.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Veera V Satya N Kanithi
Architect
United States United States
No Biography provided

Comments and Discussions

 
GeneralHelp with Nested Grid..!! Pinmemberqtrmile6916-Jul-08 6:27 
Iam a newbie (( Awww)) ...anyway ...I have been playing with the nested grid...and i have it partially working ...my problem is the Child data source is not a Text value as in the database...mine is a numeric value which is my Key value...
 
My problem is that when I run it.. i get the following error. I think it's because in the .cs file it references a field that is text in the DB... but when I run it on my data it comes back as data mismatch because its a integer..
 
Please help !!!!
 
"" My Code follows the error ""
 
Data type mismatch in criteria expression.
Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.
 
Exception Details: System.Data.OleDb.OleDbException: Data type mismatch in criteria expression.
 
Source Error:
 
Line 109: //Prepare the query for Child GridView by passing the Team Name of the parent row
Line 110: gv.DataSource = ChildDataSource(((DataRowView)e.Row.DataItem)["TeamID"].ToString(), strSort);
Line 111: gv.DataBind();
Line 112:
Line 113: }
 

Source File: c:\A\mhbdl\StatLeaders.aspx.cs Line: 111
 
Stack Trace:
 
""My Code from .cs file ""
 
//This procedure prepares the query to bind the child GridView
private AccessDataSource ChildDataSource(string strCustometId, string strSort)
{
string strQRY = "";
AccessDataSource dsTemp = new AccessDataSource();
dsTemp.DataFile = "databases/darts.mdb";
strQRY = "SELECT [PinQ].[TeamID],[PinQ].[Name]," +
"[PinQ].[SumOfOuts],[PinQ].[TPPD],[PinQ].[TeamName] FROM [PinQ]" +
"WHERE [PinQ].[TeamID] = '" + strCustometId + "'" +
"UNION ALL " +
"SELECT '" + strCustometId + "','','','','' FROM [PinQ] WHERE [PinQ].[TeamID] = '" + strCustometId + "'" +
"HAVING COUNT(*)=0 " + strSort;
 

""" and this too !!"""
 
//Prepare the query for Child GridView by passing the Team Name of the parent row
gv.DataSource = ChildDataSource(((DataRowView)e.Row.DataItem)["TeamID"].ToString(), strSort);
gv.DataBind();

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web03 | 2.8.141015.1 | Last Updated 11 Mar 2007
Article Copyright 2006 by Veera V Satya N Kanithi
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid