HtmlHelper.DropDownList Method (String, String, IEnumerable<SelectListItem>, Object, Object)

Returns an HTML drop-down list control that has the specified name, custom attributes defined by an attribute object, and default selection, and that contains the specified list items and default item.

Namespace:  System.Web.WebPages.Html
Assembly:  System.Web.WebPages (in System.Web.WebPages.dll)


Public Function DropDownList ( _
    name As String, _
    defaultOption As String, _
    selectList As IEnumerable(Of SelectListItem), _
    selectedValue As Object, _
    htmlAttributes As Object _
) As IHtmlString
Dim instance As HtmlHelper 
Dim name As String 
Dim defaultOption As String 
Dim selectList As IEnumerable(Of SelectListItem)
Dim selectedValue As Object 
Dim htmlAttributes As Object 
Dim returnValue As IHtmlString 

returnValue = instance.DropDownList(name, _
    defaultOption, selectList, selectedValue, _
public IHtmlString DropDownList(
    string name,
    string defaultOption,
    IEnumerable<SelectListItem> selectList,
    Object selectedValue,
    Object htmlAttributes
IHtmlString^ DropDownList(
    String^ name, 
    String^ defaultOption, 
    IEnumerable<SelectListItem^>^ selectList, 
    Object^ selectedValue, 
    Object^ htmlAttributes
member DropDownList : 
        name:string * 
        defaultOption:string * 
        selectList:IEnumerable<SelectListItem> * 
        selectedValue:Object * 
        htmlAttributes:Object -> IHtmlString
public function DropDownList(
    name : String, 
    defaultOption : String, 
    selectList : IEnumerable<SelectListItem>, 
    selectedValue : Object, 
    htmlAttributes : Object
) : IHtmlString


  • name
    Type: System.String
    The value to assign to the name attribute of the HTML select element.
  • defaultOption
    Type: System.String
    The text to display for the default option in the list.
  • selectedValue
    Type: System.Object
    The value that specifies the item in the list that is selected by default. The item that is selected is the first item in the list that has a matching value, or that matches the items displayed text if the item has no value.
  • htmlAttributes
    Type: System.Object
    An object that contains custom attributes for the element. The attribute names and values are retrieved through reflection by examining the properties of the object.

Return Value

Type: System.Web.IHtmlString
The HTML markup that represents the drop-down list control.


Exception Condition

name is null reference (Nothing in Visual Basic) or empty.


The returned markup consists of an HTML select element in the following form:

<select name="name" ...htmlAttributes...>
  <option value="selectList[0].Value">selectList[0].Text</option>
  <option value="selectList[1].Value">selectList[1].Text</option>
  <option value="selectList[selectedValue].Value" selected="selected">selectList[selectedValue].Text</option>

The default option appears at the start of the list and its value is empty. A default option is used to communicate that no option is being chosen from the list, such as when the drop-down control represents an optional parameter.

See Also


HtmlHelper Class

DropDownList Overload

System.Web.WebPages.Html Namespace