09 Jul 2016
As highlighted previously in one of those articles, it’s easy to get confused and stuck when trying to specify selected or default value for dropdown lists. The problem stems from the fact that, first and foremost, MSDN documentation is terrible for those things, and secondly because of the approach that Microsoft took, trying to build “one-size-fits-all” solution. But let’s not get too philosophical here and get down to the ground.
This article is one of the ‘DropDownList series’ articles that should help you in dealing with DropDownList / SelectList / SelectListItem related problems. Check out other DropDownList articles here:
There are two ways to specify which item is selected in a dropdown list, and this is the main source of confusion and problems. There are two distinct scenarios:
Let’s say you have a class ‘Country’ with two properties, ‘Id’ and ‘Name’, and you want to display a dropdown list with the country selection, where Australia is pre-selected by default (because naturally, you expect that most of your users will be from Australia).
There are at least two ways you can do that: either by using a helper class
SelectList which creates
a collection of
SelectListItem instances or by creating that collection manually in the
This is the most simple and short way of doing that. Note how
13 is used to specify default
This method is a bit more involved but it allows you use more complex logic for figuring which element should be marked as selected.
And then in your view:
There’s one BIG CAVEAT: the default value supplied via one of those methods will be completely
ignored if the value of the first parameter of
DropDownListFor (Model.CountryId in this case) is not
null. In other words, if a user had selected a value or if the model got this value set via some
other pathway (like you loaded it from a database), the default value will be ignored.
I have tripped over this myself, time and again, even when writing this article. So make sure the model field that you use to store the selected Id from the dropdown list is nullable and is set to null on the first page load.
Also, do not use
SelectedListItem to specify what user had selected, instead
use them for what they are built - to specify a default value.
Selected value is different from the default value in the way that it had, well, been selected at some point. You may have just loaded an object from a database for editing and need to render already selected country.
To do so you need to use the first argument of the
DropDownListFor function. Also, note that whatever
you specify in
SelectListItem constructors for selected value will be ignored.
Simplified controller code, which loads a user from a database, sets values on the model:
View code, uses
Model.ContryId to specify selected value:
Download fully tested and 100% working Visual Studio solution with the source code used in this article for FREE – just enter your name and email in the form below, and I’ll send you the download link right away.
You will also get access to all the source code for all existing and new articles on the site, and access to my mailing list, which receives handy timesaving tips on .NET Core programming.