Click here to Skip to main content
13,256,590 members (56,927 online)
Click here to Skip to main content
Add your own
alternative version


53 bookmarked
Posted 17 Feb 2007

ReorderList - bind to DataTable; save changes

, 14 Mar 2007
Rate this:
Please Sign up or sign in to vote.
The ReorderList is one of the coolest controls in the ASP.NET AJAX Control Toolkit. This article intends to give a basic outline of how to subclass the control so you can bind it to a DataTable and, on a Reorder event, save the new order to the database.


The ReorderList is one of the coolest controls in the ASP.NET AJAX Control Toolkit. This article intends to give a basic outline of how to subclass the control so you can bind it to a DataTable and, on a Reorder event, save the new order to the database. There is no source code to download with this article, only code sighted within. The focus of this article is on the ReorderList and not on saving and retrieving data from a database.

The Problem

The ReorderList expects as it's DataSource, an object that implements IList. My business objects work mostly with DataSets and DataTables and I wanted to bind to a DataTable. The control will load data from a DataTable but on a Reorder event an exception will be thrown stating the DataTable does not implement IList. I tried using ((IListSource)DataTable).GetList() but that didn't go anywhere.

The Solution

To begin, create a subclass of the ReorderList and override the DoReorder method like this:

using System;
using System.Data;
using AjaxControlToolkit;

namespace My.Web.UI.Controls
    public class myReorderList : ReorderList
        protected override bool DoReorder(int oldIndex, int newIndex)
            if (DataSource is DataTable)
                DataRowCollection rows = ((DataTable)DataSource).Rows;
                int NewListOrder = (int)rows[newIndex][SortOrderField];

                if (oldIndex < newIndex) //item moved down
                    for (int i = oldIndex + 1; i <= newIndex; i++)
                        rows[i][SortOrderField] = 
                    (int)rows[i][SortOrderField] - 1;
                else  //item moved up
                    for (int i = oldIndex - 1; i >= newIndex; i--)
                        rows[i][SortOrderField] = 
                    (int)rows[i][SortOrderField] + 1;
                rows[oldIndex][SortOrderField] = NewListOrder;
                return true;
                throw new InvalidOperationException
            ("DataSource is not a System.Data.DataTable.");
            return false;

Here is some example code for an aspx page that is almost exactly like the code found in ReorderList.aspx in the Samples project of the ASP.NET AJAX Control Toolkit. The one exception is the addition of OnItemReorder="ReorderList1_ItemReorder". Also notice SortOrderField="Priority". This indicates the name of the column in the data source DataTable that stores the item's order in the group. This property is used in the overridden DoReorder method in the subclass (sighted above) to store the new order. The subclassed control expects this column to be an int column.

<MyAjaxToolkit:myReorderList ID="ReorderList1" runat="server"







        <div class="itemArea">
            <asp:Label ID="Label1" runat="server"

                Text='<%# HttpUtility.HtmlEncode(Convert.ToString(Eval("Title"))) %>' />
            <asp:Label ID="Label2" runat="server"

                Text='<%# HttpUtility.HtmlEncode(Convert.ToString(Eval("Description", " - {0}"))) %>' />
        <div class="itemArea">
            <asp:TextBox ID="TextBox2" runat="server" Text='<%# Bind("Title") %>' />
            <asp:TextBox ID="TextBox3" runat="server" Text='<%# Bind("Description") %>' />
            <asp:TextBox ID="TextBox4" runat="server" Text='<%# Bind("Priority") %>' />
        <asp:Panel ID="Panel2" runat="server" CssClass="reorderCue" />
        <div class="dragHandle"></div>
        <!--<span class="code-comment"> bottom border is workaround for IE7 Beta issue where bg doesn't render --></span>
        <div style="padding-left:25px; border-bottom:thin solid transparent;">
            <asp:Panel ID="panel1" runat="server" DefaultButton="Button1">
                <asp:TextBox ID="TextBox1" runat="server" Text='<%# Bind("Title") %>' />
                <asp:Button ID="Button1" runat="server" CommandName="Insert" Text="Add" />
                <asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server"

                    ErrorMessage="Please enter some text" ControlToValidate="TextBox1" />

Then in the code behind the aspx page, we need something like this:

protected void Page_Load(object sender, EventArgs e)
    ReorderList1.ItemDataBound += 
    new EventHandler<AjaxControlToolkit.ReorderListItemEventArgs>
    if (!IsPostBack)
        // Need code here to retrieve the data source DataTable from
        // the Session object or other persistence method and assign it to
        // ReorderList1.DataSource property

void BindReorderList()
    // Need code here to fill SomeDataTable with a DataTable.
    // It must contain an int column named in the SortOrderField
    // property of the myReorderList control markup in the aspx page

    ReorderList1.DataSource = SomeDataTable;

    //Need to save SomeDataTable to the Session object or 
    //other persistence method

protected void ReorderList1_ItemReorder(object sender, 
        AjaxControlToolkit.ReorderListItemReorderEventArgs e)
    // need code to save changes made to the data source DataTable
    // The changes were made in the overridden DoReorder method
    // in the MyReorderList control



This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Rip Ryness
Web Developer
United States United States
Rip Ryness has been a professional developer since 1996 after receiving a B.S. in Computer Science from Menlo College in Atherton, CA.
He is currently seeking projects that will expand on his main interest of buiding web based business solutions. His resume and contact info can be found here (pdf).

You may also be interested in...

Comments and Discussions

GeneralMy vote of 1 Pin
Member 442594929-Jun-10 11:57
memberMember 442594929-Jun-10 11:57 
GeneralMy vote of 2 Pin
Member 44168808-Mar-09 18:20
memberMember 44168808-Mar-09 18:20 
GeneralI really suffered by this article Pin
Member 44168808-Mar-09 18:19
memberMember 44168808-Mar-09 18:19 
Emiliano Parizzi5-Jun-08 10:24
memberEmiliano Parizzi5-Jun-08 10:24 
GeneralOverriding DoReorder Pin
Emiliano Parizzi4-Jun-08 13:10
memberEmiliano Parizzi4-Jun-08 13:10 
QuestionThe name 'ReorderList1_ItemDataBound' does not exist in the current context ? Pin
superconsultant10-Jan-08 12:58
membersuperconsultant10-Jan-08 12:58 
QuestionRefresh Item Order? Pin
Graham Lannigan18-Sep-07 0:30
memberGraham Lannigan18-Sep-07 0:30 
AnswerRe: Refresh Item Order? Pin
Al Beback1-Aug-08 5:10
memberAl Beback1-Aug-08 5:10 
AnswerThe solution Pin
Al Beback3-Aug-08 6:51
memberAl Beback3-Aug-08 6:51 
QuestionDisplay the ReorderList from left to right? Pin
DPLyonnais13-Sep-07 18:53
memberDPLyonnais13-Sep-07 18:53 
GeneralRe: Display the ReorderList from left to right? Pin
_Nugs_16-Apr-08 12:53
member_Nugs_16-Apr-08 12:53 
Great question.... I would love this to act like a DataList where i would be able to specify the columns and cows and maybe even repeat direction.
GeneralRe: Display the ReorderList from left to right? Pin
_Nugs_16-Apr-08 12:54
member_Nugs_16-Apr-08 12:54 
GeneralTwo Reorderlists Pin
jabdal15-Aug-07 11:28
memberjabdal15-Aug-07 11:28 
GeneralRe: Two Reorderlists Pin
cakeman394-Apr-12 8:39
membercakeman394-Apr-12 8:39 
GeneralUnknown server tag 'ajaxToolkit:myReorderList'. Pin
jabdal15-Aug-07 7:19
memberjabdal15-Aug-07 7:19 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
Rip Ryness15-Aug-07 9:33
memberRip Ryness15-Aug-07 9:33 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
jabdal15-Aug-07 11:00
memberjabdal15-Aug-07 11:00 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
jabdal15-Aug-07 11:12
memberjabdal15-Aug-07 11:12 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
CandyMe12-Nov-07 5:38
memberCandyMe12-Nov-07 5:38 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
Rip Ryness13-Nov-07 11:48
memberRip Ryness13-Nov-07 11:48 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
CandyMe13-Nov-07 18:06
memberCandyMe13-Nov-07 18:06 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
Zubair Ahmed10-Dec-07 4:59
memberZubair Ahmed10-Dec-07 4:59 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
superconsultant16-Jan-08 8:57
membersuperconsultant16-Jan-08 8:57 
GeneralRe: Unknown server tag 'ajaxToolkit:myReorderList'. Pin
Emiliano Parizzi4-Jun-08 10:32
memberEmiliano Parizzi4-Jun-08 10:32 
Questionhow to move items one reorderlist to another reorderlist in AJAX Pin
serkanweb17-Jul-07 0:06
memberserkanweb17-Jul-07 0:06 

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

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

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.171114.1 | Last Updated 14 Mar 2007
Article Copyright 2007 by Rip Ryness
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid