Click here to Skip to main content
14,176,778 members
Click here to Skip to main content
Add your own
alternative version

Stats

47.1K views
1.1K downloads
13 bookmarked
Posted 24 Mar 2008
Licenced CPOL

DropDownList with support for the optgroup element

, 24 Mar 2008
Rate this:
Please Sign up or sign in to vote.
ASP.NET lacks for support of option groups since its first release. My goal is to fill out this hole in the .NET framework.

Introduction

I've recently noticed that many programmers miss the functionality of option groups in the .NET Framework selection controls. After a while, I decided to write my own control, that works similar to the System.Web.UI.DropDownList control available in the.NET framework. My control is available for .NET framework 2.0 or later.

Background, W3 recommendation

When working with the DropDownGroupableList control, please keep in mind the restrictions related to option groups and option items defined by the W3 Consortium. See this article. A good website programmer is not defined only through the effectiveness of his program code :-)

Data source types

Data can be delivered in four different ways:

  • Inline items definition
  • Note: this enables you to specify option groups as well as option items.

  • Manual filling in the Items collection in your code.
  • Note: Notice the AddItem and AddGroup methods exposed by the Items collection.

  • DataSource property containing valid IEnumerable data.
  • Declarative data source provided by the control referenced by the DataSourceID property.

Provided data, declarative or manual through the DataSource property, may be handled the normal way, or hierarchically - read the following paragraph.

Hierarchical data source support

If the provided data source implements IHierarchicalEnumerable, then DropDownGroupableList works a little differently according to data processing. It is based on the theory that option groups, together with items, represent some kind of two-level hierarchy.

You can control hierarchical data processing by these settings:

  • IgnoreFirstBoundParent - this instructs a list control that it should ignore the first bound parent and bind its children instead. This means that the first parent is the root of the data that is really bound. This can be helpful when binding site maps that have one root node that plays no role inside site navigation. The default value is false.
  • BindEmptyParentAsListItem - this setting controls how to process empty parents. There are generally two ways you can handle empty parents: create an option group with no child options (then it cannot be selected), or create an option item you can select. The default value is true.
  • DataGroupTextField, DataGroupTextFormatString, and DataGroupIDField - similar to the well-known properties from DropDownList, but refers to option group attributes.

Common properties

If you are familiar with the System.Web.UI.WebControls.DropDownList control (and you should be when reading this article), you probably know its functionality and behavior. Here are listed some important and commonly used capabilities that my control has in common with the standard DropDownList:

  • AppendDataBoundItems - value that specifies if the Items collection is cleared before binding data.
  • AutoPostBack - sends form back to the server after the selected item is changed.
  • CausesValidation, ValidationGroup - properties that work together to ensure the control's validity
  • DataTextField, DataValueField - names of bound object properties that contain the Text property value or the Value property value, respectively.
  • SelectedItemChanged - occurs when the selected item changes; note this event is not related to option groups since they cannot be selected.

Differences from the standard DropDownList

SelectedValue

When you set the value of the property SelectedValue to a value that corresponds to more than one item (e.g., you inserted more items with the same value), then an exception is thrown.

ListItem.Enabled

The Enabled property of the System.Web.UI.WebControls.ListItem class influences its visibility on the page. I decided to change this behavior, so setting this value to false makes it disabled via the disabled HTML attribute, but it is still being rendered.

Items collection

This collection definition works with the abstract OptionItemBase class that is implemented by the OptionListItem and OptionGroupItem classes. This enables my list control to contain option items as well as option groups at the top level. The OptionGroupItem class then may contain only OptionListItem class instances, no inner groups are allowed since it is not part of the W3 recommendation.

Samples

The attached zip file contains the following sample pages:

  • DynamicDataSource.aspx - demonstrates dynamic filling in from code-behind.
  • InlineDataDefinition.aspx - demonstrates inline Items definition.
  • HierarchicalDataSource.aspx - shows capabilities of hierarchical data source functionality.

Conclusion

It took me some noticeable time to create and debug this component, so I hope it will be helpful for all ASP.NET programmers. Feel free to use it :-)

License

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

Share

About the Author

Petr Koutny
Web Developer
Czech Republic Czech Republic
ASP.NET programmer in W.D.A. Czech, s.r.o. company.

You may also be interested in...

Comments and Discussions

 
QuestionHi admin, I can't set SelectIndexChanged for dropdownlist koutny Pin
phannhatthanh151029-Oct-17 13:06
memberphannhatthanh151029-Oct-17 13:06 
Questiondrag and drop does not work Pin
maximus.dec.meridius15-Mar-11 12:01
membermaximus.dec.meridius15-Mar-11 12:01 
Questionpre-selecting items in the drop down? Pin
madrak_ne18-Feb-10 10:39
membermadrak_ne18-Feb-10 10:39 
Generalgood controll.. it helped me a lot.. Pin
Sandeepkumar Ramani7-Feb-09 1:51
memberSandeepkumar Ramani7-Feb-09 1:51 
GeneralSelectedValue Pin
Ljerald9-Dec-08 20:32
memberLjerald9-Dec-08 20:32 
QuestionWhy you didn't attach the source code? Pin
bonifacy7-May-08 21:33
memberbonifacy7-May-08 21:33 
AnswerRe: Why you didn't attach the source code? Pin
isunshine14-May-08 5:12
memberisunshine14-May-08 5:12 
GeneralRe: Why you didn't attach the source code? Pin
Petr Koutny14-May-08 12:51
memberPetr Koutny14-May-08 12:51 
GeneralRe: Why you didn't attach the source code? Pin
Petr Koutny14-Dec-08 10:23
memberPetr Koutny14-Dec-08 10:23 

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 | Cookies | Terms of Use | Mobile
Web03 | 2.8.190525.1 | Last Updated 24 Mar 2008
Article Copyright 2008 by Petr Koutny
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid