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

Returns an HTML drop-down list control that has the specified name, 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) _
) As IHtmlString
Dim instance As HtmlHelper 
Dim name As String 
Dim defaultOption As String 
Dim selectList As IEnumerable(Of SelectListItem)
Dim returnValue As IHtmlString 

returnValue = instance.DropDownList(name, _
    defaultOption, selectList)
public IHtmlString DropDownList(
    string name,
    string defaultOption,
    IEnumerable<SelectListItem> selectList
IHtmlString^ DropDownList(
    String^ name, 
    String^ defaultOption, 
    IEnumerable<SelectListItem^>^ selectList
member DropDownList : 
        name:string * 
        defaultOption:string * 
        selectList:IEnumerable<SelectListItem> -> IHtmlString
public function DropDownList(
    name : String, 
    defaultOption : String, 
    selectList : IEnumerable<SelectListItem>
) : 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.

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">
  <option value="selectList[0].Value">selectList[0].Text</option>
  <option value="selectList[1].Value">selectList[1].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