SelectExtensions.DropDownListFor<TModel, TProperty> Method (HtmlHelper<TModel>, Expression<Func<TModel, TProperty>>, IEnumerable<SelectListItem>, String, IDictionary<String, Object>)

Visual Studio 2010

Returns an HTML select element for each property in the object that is represented by the specified expression using the specified list items, option label, and HTML attributes.

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

public static MvcHtmlString DropDownListFor<TModel, TProperty>(
	this HtmlHelper<TModel> htmlHelper,
	Expression<Func<TModel, TProperty>> expression,
	IEnumerable<SelectListItem> selectList,
	string optionLabel,
	IDictionary<string, Object> htmlAttributes
)

Type Parameters

TModel

The type of the model.

TProperty

The type of the value.

Parameters

htmlHelper
Type: System.Web.Mvc.HtmlHelper<TModel>
The HTML helper instance that this method extends.
expression
Type: System.Linq.Expressions.Expression<Func<TModel, TProperty>>
An expression that identifies the object that contains the properties to render.
selectList
Type: System.Collections.Generic.IEnumerable<SelectListItem>
A collection of SelectListItem objects that are used to populate the drop-down list.
optionLabel
Type: System.String
The text for a default empty item. This parameter can be null.
htmlAttributes
Type: System.Collections.Generic.IDictionary<String, Object>
A dictionary that contains the HTML attributes to set for the element.

Return Value

Type: System.Web.Mvc.MvcHtmlString
An HTML select element for each property in the object that is represented by the expression.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type HtmlHelper<TModel>. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

ExceptionCondition
ArgumentNullException

The expression parameter is null.

The htmlAttributes parameter consists of an object that contains name/value pairs. The attributes that are specified in the name/value pairs depend on the HTML element that is being rendered. For example, for a select element, you might provide the following anonymous object:

new { id = "select1", size="8" }

Community Additions

ADD
Show: