Click here to Skip to main content
Click here to Skip to main content
Go to top

Runtime Dependent ListBox

, 29 May 2007
Rate this:
Please Sign up or sign in to vote.
This articles describles how to add a Dependent ListBox in Runtime using Ajax (MagicAjax)

Screenshot - RuntimeDependentListBox.gif

Introduction

From time to time, I have needed to have a listbox that depends on another listbox. And not only one for each form, but as many as I needed for each form. This article explains how to accomplish this.

Using the code

This code uses MagicAjax to handle the data without having to post the whole page. The function AddDependentListBox() creates a MagicAjax AjaxPanel in RunTime. DropDownList adds it to the AjaxPanel and then adds the AjaxPanel to the page. In this example a PlaceHolder is used, but a Table or any another control will also suffice.

using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using MagicAjax;

namespace RuntimeDependentListBox
{
    public class DependentListBox : System.Web.UI.Page
    {
        protected System.Web.UI.WebControls.PlaceHolder ph;

        private void Page_Load(object sender, System.EventArgs e)
        {
            //Put user code to initialize the page here
            //AddDependentListBox(Unique Key to find 
            //each dependent list box you want to add)
            //you can add as much as you want as long as 
            //you don't repeat the Key)

            AddDependentListBox("Example_Key");
        }

        #region Web Form Designer generated code
        override protected void OnInit(EventArgs e)
        {
            //
            //CODEGEN: This call is required by the 
            //ASP.NET Web Form Designer.
            //
            InitializeComponent();
            base.OnInit(e);
        }

        /// 
        <summary />/// Required method for Designer support - do not modify<span class="code-SummaryComment"></summary />
</span>
        <summary />/// the contents of this method with the code editor.<span class="code-SummaryComment"></summary />
</span>
        <summary />/// <span class="code-SummaryComment"></summary />
</span>
        <summary /></summary />private void InitializeComponent()
        {    
            this.Load += new System.EventHandler(this.Page_Load);
        }
        #endregion

NOTE: When creating the first DropDownList, an EventHandler for the SelectedIndexChange is also created. This provides the DataBinding of the second DropDownList according to the value selected in the first. As a UniqueKey is provided in the AddDependentListBox() function, this lets the EventHandler know by the IDs which DropDownList to populate. This, in turn, lets the user add as many RunTime-dependent ListBoxes as he or she wants.

        private void AddDependentListBox(string pstrKey)
        {
            //creates a MagicAjax AjaxPanel in Runtime that is unique for 
            //each DropDownList
            MagicAjax.UI.Controls.AjaxPanel ap = 
                new MagicAjax.UI.Controls.AjaxPanel();

            //This lines creates the First DropDownlist in Runtime
            DropDownList cboFirst = new DropDownList();
            cboFirst.ID = "1_" + pstrKey;
            cboFirst.AutoPostBack = true;

            //this add the EventHandler Function to the 
            //First Dependent List Box
            cboFirst.SelectedIndexChanged += new EventHandler(
                cboFirst_SelectedIndexChanged);


            //Creation of teh second DropDownlist in RunTime
            DropDownList cboSecond = new DropDownList();
            cboSecond.ID = "2_" + pstrKey;
            cboSecond.Enabled = false;

            //Both DropDownLists are added to the 
            //MagicAjax AjaxPanel that was created
            ap.Controls.Add(cboFirst);
            ap.Controls.Add(cboSecond);

            //This line add the Created DropDownList to the PlaceHolder
            ph.Controls.Add(ap);

            //This Line Populates First DropDownlist
            PopulateFirst(pstrKey);
        }


        private void PopulateFirst(string pstrKey)
        {
            //After adding to the PlaceHolder, you can find the 
            //created DropDownList in the Page with FindControl
            //and populate it as you want
            DropDownList cboFirst = (DropDownList)Page.FindControl(
                "1_" + pstrKey);
            cboFirst.Items.Clear();
            cboFirst.Items.Add(new ListItem("Select",""));
            cboFirst.Items.Add(new ListItem("First Value","1"));
            cboFirst.Items.Add(new ListItem("Second Value","2"));
        }

        private void cboFirst_SelectedIndexChanged(object sender, 
            System.EventArgs e)
        {
            //if the index changes run this
            //the DropDownList changed
            DropDownList cboFirst = (DropDownList)sender;

            //Find the unique Key spliting the ID of the DropDownList
            string strKey = cboFirst.ID.Split('_')[1].ToString();

            //the second dropdownlist
            DropDownList cboSecond = (DropDownList)Page.FindControl(
                "2_" + strKey);

            //Poluates the Second DropDowList using the 
            //value selected from the First DropDownList
            if(cboFirst.SelectedIndex>0)
            {
                PopulateSecond(strKey, cboFirst.SelectedValue.ToString());
                cboSecond.Enabled = true;
            }
            else
            {
                cboSecond.Items.Clear();
                cboSecond.Enabled = false;
            }
        }


        private void PopulateSecond(string pstrKey, string pstrcboFirstValue)
        {
            //Populates the Second DropDownList accornding to the 
            //value selected from the first.
            DropDownList cboSecond = (DropDownList)Page.FindControl(
                "2_" + pstrKey);
            cboSecond.Items.Clear();
            if(pstrcboFirstValue=="1")
            {
                cboSecond.Items.Add(new ListItem(
                    "First Value Selected 1","1"));
                cboSecond.Items.Add(new ListItem(
                    "First Value Selected 2","2"));
                cboSecond.Items.Add(new ListItem(
                    "First Value Selected 3","3"));
            }
            else if(pstrcboFirstValue=="2")
            {
                cboSecond.Items.Add(new ListItem(
                    "Second Value Selected 1","1"));
                cboSecond.Items.Add(new ListItem(
                    "Second Value Selected 2","2"));
            }
        }
    }
}

The creation of the MagicAjax AjaxPanel in Runtime for each group of dependent ListBoxes is what allows Ajax to load only the ListBoxes that are inside their AjaxPanel, without interfering in the others.

Conclusion

Well, that's it actually. Although the code is very simple, many developers feel strange about using controls created on the fly. However, this articles uses simple code to improve dependent ListBoxes using C# and Ajax.

History

  • v1.0 22/05/2007

License

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

Share

About the Author

felipesabino
Software Developer I.ndigo - www.i.ndigo.com.br
Brazil Brazil
No Biography provided
Follow on   Twitter

Comments and Discussions

 
GeneralMy vote of 5 Pinmembermanoj kumar choubey7-Feb-12 0:09 
GeneralChange the UI of ListBox and DropDownList on the fly Pingroupelizas22-Mar-10 3:34 

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
Web01 | 2.8.140905.1 | Last Updated 29 May 2007
Article Copyright 2007 by felipesabino
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid